triggerssmith/docs/swagger.yaml

definitions:
  api_acladmin.ProblemDetails:
    properties:
      detail:
        example: No role with ID 42
        type: string
      instance:
        example: /api/acl/roles/42
        type: string
      status:
        example: 404
        type: integer
      title:
        example: Role not found
        type: string
      type:
        example: https://api.triggerssmith.com/errors/role-not-found
        type: string
    type: object
  api_acladmin.createResourceRequest:
    properties:
      key:
        example: html.view
        type: string
    type: object
  api_acladmin.createResourceResponse:
    properties:
      id:
        example: 1
        type: integer
      key:
        example: html.view
        type: string
    type: object
  api_acladmin.createRoleRequest:
    properties:
      name:
        example: admin
        type: string
    type: object
  api_acladmin.createRoleResponse:
    properties:
      id:
        example: 1
        type: integer
      name:
        example: admin
        type: string
    type: object
  api_acladmin.getResourceResponse:
    properties:
      id:
        example: 1
        type: integer
      key:
        example: html.view
        type: string
    type: object
  api_acladmin.getRoleResponse:
    properties:
      id:
        example: 1
        type: integer
      name:
        example: admin
        type: string
    type: object
  api_acladmin.getRoleUser:
    properties:
      userEmail:
        example: admin@triggerssmith.com
        type: string
      userId:
        example: 1
        type: integer
      userName:
        example: admin
        type: string
    type: object
  api_acladmin.updateResourceRequest:
    properties:
      key:
        example: html.view
        type: string
    type: object
  api_acladmin.updateResourceResponse:
    properties:
      id:
        example: 1
        type: integer
      key:
        example: html.view
        type: string
    type: object
  api_acladmin.updateRoleRequest:
    properties:
      name:
        example: admin
        type: string
    type: object
  api_acladmin.updateRoleResponse:
    properties:
      id:
        example: 1
        type: integer
      name:
        example: admin
        type: string
    type: object
info:
  contact: {}
paths:
  /api/acl/resources:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              items:
                properties:
                  id:
                    example: 1
                    type: integer
                  key:
                    example: html.view
                    type: string
                type: object
              type: array
            type: array
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Get all resources
      tags:
      - resources
    post:
      consumes:
      - application/json
      parameters:
      - description: Resource
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/api_acladmin.createResourceRequest'
      produces:
      - application/json
      responses:
        "201":
          description: Created
          schema:
            $ref: '#/definitions/api_acladmin.createResourceResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Create resource
      tags:
      - resources
  /api/acl/resources/{resourceId}:
    delete:
      parameters:
      - description: Resource ID
        example: 1
        in: path
        name: resourceId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Delete resource
      tags:
      - resources
    get:
      parameters:
      - description: Resource ID
        example: 1
        in: path
        name: resourceId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/api_acladmin.getResourceResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Get resource by ID
      tags:
      - resources
    patch:
      consumes:
      - application/json
      parameters:
      - description: Resource ID
        example: 1
        in: path
        name: resourceId
        required: true
        type: integer
      - description: Resource
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/api_acladmin.updateResourceRequest'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/api_acladmin.updateResourceResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Update resource
      tags:
      - resources
  /api/acl/roles:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              items:
                properties:
                  id:
                    example: 1
                    type: integer
                  name:
                    example: admin
                    type: string
                type: object
              type: array
            type: array
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Get all roles
      tags:
      - roles
    post:
      consumes:
      - application/json
      parameters:
      - description: Role
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/api_acladmin.createRoleRequest'
      produces:
      - application/json
      responses:
        "201":
          description: Created
          schema:
            $ref: '#/definitions/api_acladmin.createRoleResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Create role
      tags:
      - roles
  /api/acl/roles/{roleId}:
    delete:
      parameters:
      - description: Role ID
        example: 1
        in: path
        name: roleId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Delete role
      tags:
      - roles
    get:
      parameters:
      - description: Role ID
        example: 1
        in: path
        name: roleId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/api_acladmin.getRoleResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Get role by ID
      tags:
      - roles
    patch:
      consumes:
      - application/json
      parameters:
      - description: Role ID
        example: 1
        in: path
        name: roleId
        required: true
        type: integer
      - description: Role
        in: body
        name: request
        required: true
        schema:
          $ref: '#/definitions/api_acladmin.updateRoleRequest'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/api_acladmin.updateRoleResponse'
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "409":
          description: Conflict
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Update role
      tags:
      - roles
  /api/acl/roles/{roleId}/users:
    get:
      parameters:
      - description: Role ID
        example: 1
        in: path
        name: roleId
        required: true
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            items:
              items:
                $ref: '#/definitions/api_acladmin.getRoleUser'
              type: array
            type: array
        "400":
          description: Bad Request
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "404":
          description: Not Found
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
        "500":
          description: Internal Server Error
          schema:
            $ref: '#/definitions/api_acladmin.ProblemDetails'
      summary: Get role users
      tags:
      - roles
swagger: "2.0"