openapi: 3.1.0
info:
  title: SysAid REST ActionItems ServiceRecords 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: ServiceRecords
paths:
  /createservicerecord:
    post:
      tags:
      - ServiceRecords
      summary: Create ticket
      operationId: createServiceRecord
      responses:
        '201':
          description: Created
  /getservicerecordbyid:
    get:
      tags:
      - ServiceRecords
      summary: Retrieve ticket details
      operationId: getServiceRecordById
      responses:
        '200':
          description: OK
  /updateservicerecord:
    put:
      tags:
      - ServiceRecords
      summary: Update ticket
      operationId: updateServiceRecord
      responses:
        '200':
          description: OK
  /searchservicerecords:
    get:
      tags:
      - ServiceRecords
      summary: Search tickets by parameters
      operationId: searchServiceRecords
      responses:
        '200':
          description: OK
  /deleteservicerecord:
    delete:
      tags:
      - ServiceRecords
      summary: Remove ticket permanently
      operationId: deleteServiceRecord
      responses:
        '204':
          description: Deleted
  /resolveservicerecord:
    post:
      tags:
      - ServiceRecords
      summary: Mark ticket resolved
      operationId: resolveServiceRecord
      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>".'