Some Private Resource Service API Template

some-service-api.yaml

swagger: "2.0"
info:
  version: x.y.z
  title: Some Private Resource Service API
host: some-service.domain
basePath: /
schemes:
  - http
  - https
consumes:
  - application/json
produces:
  - application/json
paths:
  /resourses/status/{resourceId}:
    post:
      summary: Change a status of a resource for users
      parameters:
        - name: resourceId
          in: path
          description: The id of the resource
          type: string
          required: true
        - name: users
          description: Array of userIds
          in: body
          required: true
          schema:
            type: array
            items:
              type: string
      responses:
        201:
          description: Statuses successfuly changed
        400:
          description: Validation error
definitions:
  User:
    properties:
      id:
        type: string
        description: User ID
  ApiError:
    properties:
      message:
        type: string
        description: Text error message
      code:
        type: integer
        description: Numeric error code
      payload:
        type: object
        description: Error payload. No schema