Custom Status Code when returning a JsonResource

[axelrindle]

I'm customizing the Http Status Code in some endpoints when returning a JsonResource like the following:

return (new MyResource($instance))
    ->response()
    ->setStatusCode(201);

The generated OpenAPI spec however incorrectly shows a 200 status code in the response.

Scramble should correctly infer the set status code. If that is not possible, I'd like to use @status 201 in the function's docblock.

[axelrindle]

Well, I just read about Response description and that worked:

/**
 * MyResource
 *
 * @status 201
 * @body MyResource
 */
return (new MyResource($instance))
    ->response()
    ->setStatusCode(201);