openapi: 3.1.0
info:
  title: SysAid REST ActionItems Companies 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: Companies
paths:
  /getcompanies:
    get:
      tags:
      - Companies
      summary: List companies
      operationId: getCompanies
      responses:
        '200':
          description: OK
  /createcompany:
    post:
      tags:
      - Companies
      summary: Create company
      operationId: createCompany
      responses:
        '201':
          description: Created
  /getcompanybyid:
    get:
      tags:
      - Companies
      summary: Retrieve company by ID
      operationId: getCompanyById
      responses:
        '200':
          description: OK
  /updatecompanybyid:
    put:
      tags:
      - Companies
      summary: Update company
      operationId: updateCompanyById
      responses:
        '200':
          description: OK
  /deletecompanybyid:
    delete:
      tags:
      - Companies
      summary: Remove company
      operationId: deleteCompanyById
      responses:
        '204':
          description: Deleted
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>".'