Define a response object with an array in YAML using Swagger Editor

Wesley Smith picture Wesley Smith · Nov 7, 2016 · Viewed 27.5k times · Source

I'm working on an API definition in Swagger Editor with YAML. I am trying to represent the following response body:

{
    success: true,
    ids: [123456, ...]
}

and this is what my YAML looks like:

definitions:
  SuccessfulResponse:
    type: object 
    properties:
      success:
        type: boolean
        description: True if the all operations were successful
      ids:
        type: array
        items: 
          id: 
          type: string 

Ive tried several different ways but like this but nothing seems valid

enter image description here

How do I properly describe the return object that Ive given above?

Answer

William Cheng picture William Cheng · Nov 7, 2016

Here is an example to define a property as an array of string:

  photoUrls:
    type: array
    items:
      type: string

Ref: https://github.com/OpenAPITools/openapi-generator/blob/master/modules/openapi-generator/src/test/resources/2_0/petstore.yaml#L661-L667