openapi: 3.1.0
info:
  title: SysAid REST ActionItems Auth API
  description: 'REST API for SysAid ITSM. Manage service records (incidents, requests, problems, changes), users (agents and end users), groups, companies, assets, configuration items (CIs), templates, attachments, webhooks (beta), and license manager records. Authentication uses Client Credentials to mint short-lived application access tokens. Source: https://developers.sysaid.com/'
  version: '1.0'
  contact:
    name: SysAid
    url: https://developers.sysaid.com/
servers:
- url: https://your-account.sysaidit.com
  description: SysAid tenant base URL (replace your-account)
security:
- BearerAuth: []
tags:
- name: Auth
paths:
  /createapplicationkey:
    post:
      tags:
      - Auth
      summary: Create app credentials
      operationId: createApplicationKey
      responses:
        '201':
          description: Created
  /generateaccesstoken:
    post:
      tags:
      - Auth
      summary: Obtain access token
      operationId: generateAccessToken
      responses:
        '200':
          description: OK
  /deleteapplicationkey:
    delete:
      tags:
      - Auth
      summary: Remove app credentials
      operationId: deleteApplicationKey
      responses:
        '204':
          description: Deleted
  /getapplicationsbyaccountid:
    get:
      tags:
      - Auth
      summary: List app keys by account
      operationId: getApplicationsByAccountId
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'OAuth 2.0 Client Credentials grant: exchange client_id and client_secret at /generateaccesstoken for a short-lived access token (default 24h), then pass as "Authorization: Bearer <token>".'