openapi: 3.1.0
info:
title: SysAid REST ActionItems EndUsers 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: EndUsers
paths:
/getendusers:
get:
tags:
- EndUsers
summary: List end users (paginated)
operationId: getEndUsers
responses:
'200':
description: OK
/createenduser:
post:
tags:
- EndUsers
summary: Create new end user
operationId: createEndUser
responses:
'201':
description: Created
/getenduser:
get:
tags:
- EndUsers
summary: Retrieve end user by ID
operationId: getEndUser
responses:
'200':
description: OK
/updateenduser:
put:
tags:
- EndUsers
summary: Update end user details
operationId: updateEndUser
responses:
'200':
description: OK
/deleteenduser:
delete:
tags:
- EndUsers
summary: Remove end user permanently
operationId: deleteEndUser
responses:
'204':
description: Deleted
/addendusertogroups:
post:
tags:
- EndUsers
summary: Add end user to groups
operationId: addEndUserToGroups
responses:
'200':
description: OK
/removeenduserfromgroups:
post:
tags:
- EndUsers
summary: Remove end user from groups
operationId: removeEndUserFromGroups
responses:
'200':
description: OK
/convertendusertoagent:
post:
tags:
- EndUsers
summary: Convert end user to agent
operationId: convertEndUserToAgent
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>".'