/posts:
  get:
    description: Returns an array of post objects.
    parameters:
      - name: page
        in: query
        type: string
        default: 1
      - name: limit
        in: query
        type: string
        default: 25
      - name: query
        in: query
        type: string
    security:
      - jwt: []
    responses:
      403:
        $ref: '#/responses/Unauthorized'
      400:
        $ref: '#/responses/BadRequest'
      200:
        $ref: '#/responses/Posts'
  post:
    description: Creates a new post.
    parameters:
      - name: body
        in: body
        schema:
          $ref: '#/definitions/Post'
    security:
      - jwt: []
    responses:
      403:
        $ref: '#/responses/Unauthorized'
      400:
        $ref: '#/responses/BadRequest'
      200:
        $ref: '#/responses/Post'
/posts/{id}:
  get:
    description: Returns a single post object.
    parameters:
      - name: id
        in: path
        type: string
      - name: with
        in: query
        type: string
        default:
    security:
      - jwt: []
    responses:
      403:
        $ref: '#/responses/Unauthorized'
      404:
        $ref: '#/responses/NotFound'
      400:
        $ref: '#/responses/BadRequest'
      200:
        $ref: '#/responses/Post'
  put:
    description: Updates a single post object.
    parameters:
      - name: id
        in: path
        type: string
      - name: body
        in: body
        schema:
          $ref: '#/definitions/Post'
    security:
      - jwt: []
    responses:
      403:
        $ref: '#/responses/Unauthorized'
      404:
        $ref: '#/responses/NotFound'
      400:
        $ref: '#/responses/BadRequest'
      200:
        $ref: '#/responses/Post'
  delete:
    description: Deletes a single post object.
    parameters:
      - name: id
        in: path
        type: string
    security:
      - jwt: []
    responses:
      403:
        $ref: '#/responses/Unauthorized'
      404:
        $ref: '#/responses/NotFound'
      400:
        $ref: '#/responses/BadRequest'
      200:
        $ref: '#/responses/Post'
