openapi: 3.1.0
info:
  title: SysAid REST ActionItems Groups 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: Groups
paths:
  /getgroups:
    get:
      tags:
      - Groups
      summary: List all groups (paginated)
      operationId: getGroups
      responses:
        '200':
          description: OK
  /creategroup:
    post:
      tags:
      - Groups
      summary: Create new group
      operationId: createGroup
      responses:
        '201':
          description: Created
  /getgroup:
    get:
      tags:
      - Groups
      summary: Retrieve group by ID
      operationId: getGroup
      responses:
        '200':
          description: OK
  /getgroupmembers:
    get:
      tags:
      - Groups
      summary: List group members
      operationId: getGroupMembers
      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>".'