openapi: 3.1.0
info:
  title: SysAid REST ActionItems Assets 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: Assets
paths:
  /getassets:
    get:
      tags:
      - Assets
      summary: List assets
      operationId: getAssets
      responses:
        '200':
          description: OK
  /createasset:
    post:
      tags:
      - Assets
      summary: Create asset
      operationId: createAsset
      responses:
        '201':
          description: Created
  /getassetbyid:
    get:
      tags:
      - Assets
      summary: Retrieve asset by ID
      operationId: getAssetById
      responses:
        '200':
          description: OK
  /updateasset:
    put:
      tags:
      - Assets
      summary: Update asset
      operationId: updateAsset
      responses:
        '200':
          description: OK
  /deleteasset:
    delete:
      tags:
      - Assets
      summary: Remove asset
      operationId: deleteAsset
      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>".'