swagger: '2.0'

info:
  version: "1.0.0"
  title: Private to-do list
  description: |
    A very simple api description that makes a json only API to submit to do's.

produces:
  - application/json

consumes:
  - application/json

paths:
  /collection:
    get:
      operationId: collection
      parameters:
        - name: "workspace_id"
          in: "query"
          required: true
          type: "array"
          items:
            type: "string"
            format: "uuid"
      responses:
        '200':
          description: returns single item
          headers:
            'X-Request-Id':
              required: true
              type: "array"
              items:
                type: "string"
                format: "uuid"
  /single:
    get:
      operationId: single
      parameters:
        - name: "workspace_id"
          in: "query"
          required: true
          type: "string"
          format: "uuid"
      responses:
        '200':
          description: returns single item
          headers:
            'X-Request-Id':
              type: string
              required: true
              format: uuid
  /{id}:
    get:
      operationId: details
      parameters:
        - name: "id"
          in: "path"
          required: true
          type: "string"
          format: "uuid"

definitions:
  genericResource:
    description: generic resource
    properties:
      meta:
        type: string
    required:
      - meta
    additionalProperties:
      type: object
