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>".'