{
  "openapi": "3.0.1",
  "info": {
    "title": "Arxus Care API",
    "description": "ITSM e-bonding API for Arxus partners and customers.",
    "version": "v0"
  },
  "servers": [
    {
      "url": "https://api-dev.arxus.eu/care/v0/",
      "description": "Development ( Arxus internal use only )"
    },
    {
      "url": "https://api-acc.arxus.eu/care/v0/",
      "description": "Acceptance( Arxus internal use only )"
    },
    {
      "url": "https://api.arxus.eu/care/v0/",
      "description": "Production"
    }
  ],
  "components": {
    "securitySchemes": {
      "ArxusSSO": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "parameters": {
      "contract_id": {
        "name": "contractId",
        "in": "path",
        "description": "The unique identifier of the contract.",
        "required": true,
        "schema": {
          "type": "string",
          "example": "60afa4b6519c8660f08b2d63"
        }
      },
      "case_id": {
        "name": "caseId",
        "in": "path",
        "description": "The unique identifier of the case.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "attachment_id": {
        "name": "attachmentId",
        "in": "path",
        "description": "The unique identifier of the attachment.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "comment_id": {
        "name": "commentId",
        "in": "path",
        "description": "The unique identifier of the comment.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "webhook_id": {
        "name": "webhookId",
        "in": "path",
        "description": "The unique identifier of the webhook.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "event_id": {
        "name": "eventId",
        "in": "path",
        "description": "The unique identifier of the event.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "key_id": {
        "name": "keyId",
        "in": "path",
        "description": "The unique identifier of the API key.",
        "required": true,
        "schema": {
          "type": "string",
          "example": "507f1f77bcf86cd799439011"
        }
      }
    },
    "schemas": {
      "page_info": {
        "title": "Page info",
        "description": "Pagination info for the response.",
        "type": "object",
        "properties": {
          "number": {
            "title": "Page Number",
            "description": "The current page number.",
            "type": "integer",
            "format": "int32",
            "example": 1
          },
          "size": {
            "title": "Page Size",
            "description": "The number of items per page.",
            "type": "integer",
            "format": "int32",
            "example": 50
          },
          "count": {
            "title": "Count",
            "description": "The number of items in the current page.",
            "type": "integer",
            "format": "int32",
            "example": 20
          },
          "totalCount": {
            "title": "Total Count",
            "description": "The total number of items.",
            "type": "integer",
            "format": "int32",
            "example": 42
          }
        }
      },
      "meta_empty": {
        "title": "Response metadata",
        "description": "Response metadata schema.",
        "type": "object"
      },
      "meta_page": {
        "title": "Response metadata",
        "description": "Meta information about the response.",
        "type": "object",
        "properties": {
          "page": {
            "$ref": "#/components/schemas/page_info"
          }
        }
      },
      "error": {
        "title": "Error",
        "description": "An error that occurred.",
        "type": "object",
        "properties": {
          "status": {
            "description": "The HTTP status code of the error.",
            "type": "integer",
            "format": "int32",
            "example": 404
          },
          "title": {
            "description": "A short, human-readable summary of the error.",
            "type": "string",
            "example": "Not Found"
          },
          "detail": {
            "description": "A human-readable explanation of the error.",
            "type": "string",
            "example": "The requested resource was not found."
          },
          "code": {
            "description": "A machine-readable error code.",
            "type": "string",
            "example": "resource_not_found"
          }
        }
      },
      "admin_api_key": {
        "title": "API Key",
        "x-tags": [
          "Resources"
        ],
        "description": "An API key (admin view, includes scope).",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the API key.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "keyPrefix": {
            "description": "The first 8 characters of the API key for identification.",
            "type": "string",
            "example": "care_k1a"
          },
          "label": {
            "description": "A human-readable label for the API key.",
            "type": "string",
            "example": "Production key"
          },
          "scope": {
            "description": "The authorization scope of the API key.",
            "type": "string",
            "enum": [
              "admin",
              "trigger",
              "company"
            ],
            "example": "admin"
          },
          "scopeRef": {
            "description": "The company id when scope is \"company\"; null otherwise.",
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "example": 12345
          },
          "created": {
            "description": "The date and time the API key was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the API key was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          },
          "expires": {
            "description": "The optional expiry date and time of the API key.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2027-01-01T00:00:00Z"
          },
          "revoked": {
            "description": "The soft-delete date and time of the API key, or null if active.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": null
          },
          "lastUsed": {
            "description": "The date and time of the last successful authentication, or null.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2025-06-01T12:00:00Z"
          }
        }
      },
      "admin_api_key_secret": {
        "title": "API Key (with secret)",
        "x-tags": [
          "Resources"
        ],
        "description": "Schema returned once when an API key is created via the admin API.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the API key.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "key": {
            "description": "The raw API key. Shown only once and cannot be retrieved again.",
            "type": "string",
            "example": "care_k1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6"
          },
          "keyPrefix": {
            "description": "The first 8 characters of the API key for identification.",
            "type": "string",
            "example": "care_k1a"
          },
          "label": {
            "description": "A human-readable label for the API key.",
            "type": "string",
            "example": "Production key"
          },
          "scope": {
            "description": "The authorization scope of the API key.",
            "type": "string",
            "enum": [
              "admin",
              "trigger",
              "company"
            ],
            "example": "admin"
          },
          "scopeRef": {
            "description": "The company id when scope is \"company\"; null otherwise.",
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "example": 12345
          },
          "created": {
            "description": "The date and time the API key was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "expires": {
            "description": "The optional expiry date and time of the API key.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2027-01-01T00:00:00Z"
          }
        }
      },
      "admin_contract": {
        "title": "Contract",
        "x-tags": [
          "Resources"
        ],
        "description": "A contract.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the contract.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "company": {
            "description": "The company associated with the contract.",
            "type": "integer",
            "format": "int32",
            "example": 1001
          },
          "companyName": {
            "description": "The name of the company (customer or partner) associated with the contract.",
            "type": "string",
            "example": "Acme Corp"
          },
          "customer": {
            "description": "The customer code associated with the contract.",
            "type": "string",
            "example": "CUST-001"
          },
          "customerName": {
            "description": "The name of the customer associated with the contract.",
            "type": "string",
            "example": "Acme Customer"
          },
          "externalId": {
            "description": "The external unique identifier of the contract.",
            "type": "string",
            "nullable": true,
            "example": "EXT-CON-001"
          },
          "created": {
            "description": "The date and time the contract was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the contract was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          }
        }
      },
      "api_key": {
        "title": "API Key",
        "x-tags": [
          "Resources"
        ],
        "description": "A company-scoped API key.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the API key.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "keyPrefix": {
            "description": "The first 8 characters of the API key for identification.",
            "type": "string",
            "example": "care_k1a"
          },
          "label": {
            "description": "A human-readable label for the API key.",
            "type": "string",
            "example": "Production key"
          },
          "created": {
            "description": "The date and time the API key was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the API key was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          },
          "expires": {
            "description": "The optional expiry date and time of the API key.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2027-01-01T00:00:00Z"
          },
          "revoked": {
            "description": "The soft-delete date and time of the API key, or null if active.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": null
          },
          "lastUsed": {
            "description": "The date and time of the last successful authentication, or null.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2025-06-01T12:00:00Z"
          }
        }
      },
      "api_key_secret": {
        "title": "API Key (with secret)",
        "x-tags": [
          "Resources"
        ],
        "description": "A newly created API key, including the raw key value (shown only once).",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the API key.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "key": {
            "description": "The raw API key. Shown only once and cannot be retrieved again.",
            "type": "string",
            "example": "care_k1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6"
          },
          "keyPrefix": {
            "description": "The first 8 characters of the API key for identification.",
            "type": "string",
            "example": "care_k1a"
          },
          "label": {
            "description": "A human-readable label for the API key.",
            "type": "string",
            "example": "Production key"
          },
          "created": {
            "description": "The date and time the API key was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "expires": {
            "description": "The optional expiry date and time of the API key.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": "2027-01-01T00:00:00Z"
          }
        }
      },
      "case_attachment": {
        "title": "Attachment",
        "x-tags": [
          "Resources"
        ],
        "description": "A case attachment.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the attachment.",
            "type": "string",
            "example": "2719a1682b958790ed5cf651d891bfae"
          },
          "filename": {
            "description": "The file name of the attachment.",
            "type": "string",
            "example": "screenshot.png"
          },
          "contentType": {
            "description": "The content type of the attachment.",
            "type": "string",
            "example": "image/png"
          },
          "sizeBytes": {
            "description": "The size of the attachment in bytes.",
            "type": "integer",
            "format": "int32",
            "example": 1048576
          },
          "hash": {
            "description": "The hash of the attachment.",
            "type": "string",
            "example": "d41d8cd98f00b204e9800998ecf8427e"
          },
          "created": {
            "description": "The date and time the attachment was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the attachment was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          }
        }
      },
      "case_comment": {
        "title": "Comment",
        "x-tags": [
          "Resources"
        ],
        "description": "A case comment.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the comment.",
            "type": "string",
            "example": "2719a1682b958790ed5cf651d891bfae"
          },
          "type": {
            "description": "The comment type.",
            "type": "string",
            "enum": [
              "comment",
              "partnerComment"
            ],
            "example": "comment"
          },
          "contact": {
            "description": "The email address of the user who placed the comment.",
            "type": "string",
            "format": "email",
            "example": "user@example.com"
          },
          "comment": {
            "description": "The comment text.",
            "type": "string",
            "example": "This issue has been escalated to the network team."
          },
          "created": {
            "description": "The date and time the comment was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          }
        }
      },
      "case": {
        "title": "Case",
        "x-tags": [
          "Resources"
        ],
        "description": "A customer case.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the case.",
            "type": "string",
            "example": "CS0123456"
          },
          "externalId": {
            "description": "The external unique identifier of the case.",
            "type": "string",
            "nullable": true,
            "example": "EXT-12345"
          },
          "contract": {
            "description": "The unique identifier of the contract associated with the case.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "channel": {
            "description": "The channel through which the case was created.",
            "type": "string",
            "enum": [
              "api",
              "arxus_portal",
              "email",
              "monitoring",
              "phone",
              "self-service",
              "web"
            ],
            "example": "api"
          },
          "priority": {
            "description": "The priority of the case:\n  * `1` - Critical\n  * `2` - High\n  * `3` - Moderate\n  * `4` - Low\n",
            "type": "integer",
            "format": "int32",
            "enum": [
              1,
              2,
              3,
              4
            ],
            "example": 4
          },
          "state": {
            "description": "The state of the case:\n  * `1` - New\n  * `3` - Closed\n  * `6` - Resolved\n  * `7` - Cancelled\n  * `10` - Open\n  * `11` - On Hold\n  * `18` - Awaiting Info\n",
            "type": "integer",
            "format": "int32",
            "enum": [
              1,
              3,
              6,
              7,
              10,
              11,
              18
            ],
            "example": 1
          },
          "contact": {
            "description": "The contact email address on the case.",
            "type": "string",
            "format": "email",
            "nullable": true,
            "example": "user@example.com"
          },
          "shortDescription": {
            "description": "A short description of the case.",
            "type": "string",
            "example": "Server is unresponsive"
          },
          "description": {
            "description": "A detailed description of the case.",
            "type": "string",
            "example": "The production server has been unresponsive since 10:00 AM."
          },
          "incident": {
            "description": "The incident number associated with the case.",
            "type": "string",
            "nullable": true,
            "example": "INC0001234"
          },
          "change": {
            "description": "The change number associated with the case.",
            "type": "string",
            "nullable": true,
            "example": "CHG0001234"
          },
          "problem": {
            "description": "The problem number associated with the case.",
            "type": "string",
            "nullable": true,
            "example": "PRB0001234"
          },
          "created": {
            "description": "The date and time the case was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the case was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          },
          "closed": {
            "description": "The date and time the case was closed.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": null
          },
          "resolutionCode": {
            "description": "The resolution code of the case.",
            "type": "integer",
            "format": "int32",
            "nullable": true,
            "example": null
          },
          "resolutionNotes": {
            "description": "Notes about the resolution of the case.",
            "type": "string",
            "nullable": true,
            "example": null
          }
        }
      },
      "contract": {
        "title": "Contract",
        "x-tags": [
          "Resources"
        ],
        "description": "A Care API contract.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the contract.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "companyName": {
            "description": "The name of the company (customer or partner) associated with the contract.",
            "type": "string",
            "example": "Acme Corp"
          },
          "customerName": {
            "description": "The name of the customer associated with the contract.",
            "type": "string",
            "example": "Acme Customer"
          },
          "externalId": {
            "description": "The external unique identifier of the contract.",
            "type": "string",
            "nullable": true,
            "example": "EXT-CON-001"
          },
          "created": {
            "description": "The date and time the contract was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the contract was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          }
        }
      },
      "event": {
        "title": "Event",
        "x-tags": [
          "Resources"
        ],
        "description": "An event triggered by the Care API.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the event.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "event": {
            "description": "The event type that triggered the webhook.",
            "type": "string",
            "example": "case.updated"
          },
          "subject": {
            "description": "The subject identifier (e.g. case number) related to the event.",
            "type": "string",
            "example": "CS0123456"
          },
          "contract": {
            "description": "The unique identifier of the contract that triggered the webhook.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "webhook": {
            "description": "The unique identifier of the webhook that was triggered, or null if no webhook matched the event.",
            "type": "string",
            "nullable": true,
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "url": {
            "description": "The URL that was called, or null if no webhook matched the event.",
            "type": "string",
            "format": "uri",
            "nullable": true,
            "example": "https://example.com/webhooks/care"
          },
          "auth": {
            "$ref": "#/components/schemas/webhook_secret_version"
          },
          "status": {
            "description": "The status of the webhook call, or null if no webhook matched the event.",
            "type": "string",
            "enum": [
              "unknown",
              "success",
              "error"
            ],
            "nullable": true,
            "example": "success"
          },
          "created": {
            "description": "The date and time the event was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the event was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          }
        }
      },
      "mock_case_event": {
        "title": "case event trigger input",
        "description": "Input to trigger a case event.",
        "type": "object",
        "properties": {
          "caseId": {
            "description": "The case number to simulate the event for.",
            "type": "string",
            "example": "CS0123456"
          }
        },
        "required": [
          "caseId"
        ]
      },
      "mock_case_updated_event": {
        "title": "case.updated event trigger input",
        "description": "Input to trigger a case.updated event.",
        "type": "object",
        "properties": {
          "caseId": {
            "description": "The case number to simulate the event for.",
            "type": "string",
            "example": "CS0123456"
          },
          "updatedFields": {
            "description": "Specify the updated fields for the event.",
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "string"
            },
            "example": [
              "priority",
              "state"
            ]
          }
        },
        "required": [
          "caseId",
          "updatedFields"
        ]
      },
      "mock_case_attachment_event": {
        "title": "Case attachment event trigger input",
        "description": "Input to trigger a case attachment event.",
        "type": "object",
        "properties": {
          "caseId": {
            "description": "The case number to simulate the event for.",
            "type": "string",
            "example": "CS0123456"
          },
          "attachmentId": {
            "description": "The unique identifier of the attachment.",
            "type": "string",
            "example": "2719a1682b958790ed5cf651d891bfae"
          }
        },
        "required": [
          "caseId",
          "attachmentId"
        ]
      },
      "mock_case_comment_event": {
        "title": "Case Comment event trigger input",
        "description": "Input to trigger a case comment event.",
        "type": "object",
        "properties": {
          "caseId": {
            "description": "The case number to simulate the event for.",
            "type": "string",
            "example": "CS0123456"
          },
          "commentId": {
            "description": "The unique identifier of the comment.",
            "type": "string",
            "example": "2719a1682b958790ed5cf651d891bfae"
          }
        },
        "required": [
          "caseId",
          "commentId"
        ]
      },
      "trigger_case_event": {
        "title": "Trigger case event input",
        "description": "Input to trigger a case event.",
        "type": "object",
        "properties": {
          "sysId": {
            "description": "The case sys_id.",
            "type": "string"
          },
          "caseNumber": {
            "description": "The case number (ServiceNow case field: number).",
            "type": "string"
          },
          "customer": {
            "description": "The customer contract code assigned to the case (ServiceNow case field: contract.vendor_contract).",
            "type": "string"
          },
          "externalId": {
            "description": "The external unique identifier of the case (ServiceNow case field: u_customer_reference).",
            "type": "string",
            "nullable": true
          },
          "channel": {
            "description": "The channel through which the case was created (ServiceNow case field: contact_type).",
            "type": "string"
          },
          "priority": {
            "description": "The priority of the case (ServiceNow case field: priority).",
            "type": "integer",
            "format": "int32"
          },
          "state": {
            "description": "The state of the case (ServiceNow case field: state).",
            "type": "integer",
            "format": "int32"
          },
          "contact": {
            "description": "The contact email address on the case (ServiceNow case field: contact.email).",
            "type": "string"
          },
          "shortDescription": {
            "description": "A short description of the case (ServiceNow case field: short_description).",
            "type": "string"
          },
          "description": {
            "description": "A detailed description of the case (ServiceNow case field: description).",
            "type": "string"
          },
          "incident": {
            "description": "The incident number associated with the case (ServiceNow case field: incident.number).",
            "type": "string",
            "nullable": true
          },
          "change": {
            "description": "The change number associated with the case (ServiceNow case field: change.number).",
            "type": "string",
            "nullable": true
          },
          "problem": {
            "description": "The problem number associated with the case (ServiceNow case field: problem.number).",
            "type": "string",
            "nullable": true
          },
          "created": {
            "description": "The date and time the case was created (ServiceNow case field: sys_created_on).",
            "type": "string",
            "format": "date-time"
          },
          "updated": {
            "description": "The date and time the case was last updated (ServiceNow case field: sys_updated_on).",
            "type": "string",
            "format": "date-time"
          },
          "closed": {
            "description": "The date and time the case was closed (ServiceNow case field: closed_at).",
            "nullable": true
          },
          "resolutionCode": {
            "description": "The resolution code of the case (ServiceNow case field: resolution_code).",
            "type": "string",
            "nullable": true
          },
          "resolutionNotes": {
            "description": "Notes about the resolution of the case (ServiceNow case field: close_notes).",
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "sysId",
          "caseNumber",
          "customer",
          "externalId",
          "channel",
          "priority",
          "state",
          "contact",
          "shortDescription",
          "description",
          "incident",
          "change",
          "problem",
          "created",
          "updated",
          "closed",
          "resolutionCode",
          "resolutionNotes"
        ]
      },
      "trigger_case_updated_event": {
        "title": "Trigger case.updated event input",
        "description": "Input to trigger a case.updated event.",
        "type": "object",
        "properties": {
          "sysId": {
            "description": "The case sys_id.",
            "type": "string"
          },
          "caseNumber": {
            "description": "The case number (ServiceNow case field: number).",
            "type": "string"
          },
          "customer": {
            "description": "The customer contract code assigned to the case (ServiceNow case field: contract.vendor_contract).",
            "type": "string"
          },
          "externalId": {
            "description": "The external unique identifier of the case (ServiceNow case field: u_customer_reference).",
            "type": "string",
            "nullable": true
          },
          "channel": {
            "description": "The channel through which the case was created (ServiceNow case field: contact_type).",
            "type": "string"
          },
          "priority": {
            "description": "The priority of the case (ServiceNow case field: priority).",
            "type": "integer",
            "format": "int32"
          },
          "state": {
            "description": "The state of the case (ServiceNow case field: state).",
            "type": "integer",
            "format": "int32"
          },
          "contact": {
            "description": "The contact email address on the case (ServiceNow case field: contact.email).",
            "type": "string"
          },
          "shortDescription": {
            "description": "A short description of the case (ServiceNow case field: short_description).",
            "type": "string"
          },
          "description": {
            "description": "A detailed description of the case (ServiceNow case field: description).",
            "type": "string"
          },
          "incident": {
            "description": "The incident number associated with the case (ServiceNow case field: incident.number).",
            "type": "string",
            "nullable": true
          },
          "change": {
            "description": "The change number associated with the case (ServiceNow case field: change.number).",
            "type": "string",
            "nullable": true
          },
          "problem": {
            "description": "The problem number associated with the case (ServiceNow case field: problem.number).",
            "type": "string",
            "nullable": true
          },
          "created": {
            "description": "The date and time the case was created (ServiceNow case field: sys_created_on).",
            "type": "string",
            "format": "date-time"
          },
          "updated": {
            "description": "The date and time the case was last updated (ServiceNow case field: sys_updated_on).",
            "type": "string",
            "format": "date-time"
          },
          "closed": {
            "description": "The date and time the case was closed (ServiceNow case field: closed_at).",
            "nullable": true
          },
          "resolutionCode": {
            "description": "The resolution code of the case (ServiceNow case field: resolution_code).",
            "type": "string",
            "nullable": true
          },
          "resolutionNotes": {
            "description": "Notes about the resolution of the case (ServiceNow case field: close_notes).",
            "type": "string",
            "nullable": true
          },
          "updatedFields": {
            "description": "The fields that were updated on the case.",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "sysId",
          "caseNumber",
          "customer",
          "externalId",
          "channel",
          "priority",
          "state",
          "contact",
          "shortDescription",
          "description",
          "incident",
          "change",
          "problem",
          "created",
          "updated",
          "closed",
          "resolutionCode",
          "resolutionNotes",
          "updatedFields"
        ]
      },
      "trigger_attachment_event": {
        "title": "Trigger attachment event input",
        "description": "Input to trigger an attachment event.",
        "type": "object",
        "properties": {
          "caseNumber": {
            "description": "The case number (ServiceNow case field: number).",
            "type": "string"
          },
          "customer": {
            "description": "The customer contract code assigned to the case (ServiceNow case field: contract.vendor_contract).",
            "type": "string"
          },
          "id": {
            "description": "The attachment sys_id (ServiceNow attachment field: sys_id).",
            "type": "string"
          },
          "filename": {
            "description": "The file name of the attachment (ServiceNow attachment field: file_name).",
            "type": "string"
          },
          "contentType": {
            "description": "The content type of the attachment (ServiceNow attachment field: content_type).",
            "type": "string"
          },
          "sizeBytes": {
            "description": "The size of the attachment in bytes (ServiceNow attachment field: size_bytes).",
            "type": "integer",
            "format": "int32"
          },
          "hash": {
            "description": "The hash of the attachment (ServiceNow attachment field: hash).",
            "type": "string"
          },
          "created": {
            "description": "The date and time the attachment was created (ServiceNow attachment field: sys_created_on).",
            "type": "string",
            "format": "date-time"
          },
          "updated": {
            "description": "The date and time the attachment was last updated (ServiceNow attachment field: sys_updated_on).",
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "caseNumber",
          "customer",
          "id",
          "filename",
          "contentType",
          "sizeBytes",
          "hash",
          "created",
          "updated"
        ]
      },
      "trigger_comment_event": {
        "title": "Trigger comment event input",
        "description": "Input to trigger a comment event.",
        "type": "object",
        "properties": {
          "caseNumber": {
            "description": "The case number (ServiceNow case field: number).",
            "type": "string"
          },
          "customer": {
            "description": "The customer contract code assigned to the case (ServiceNow case field: contract.vendor_contract).",
            "type": "string"
          },
          "id": {
            "description": "The comment sys_id (ServiceNow comment field: sys_id).",
            "type": "string"
          },
          "partnerId": {
            "description": "The partner ID associated with the case (ServiceNow case field: u_partner_id).",
            "type": "string",
            "nullable": true
          },
          "type": {
            "description": "The comment type (ServiceNow comment field: element).",
            "type": "string"
          },
          "contact": {
            "description": "The email address of the user who placed the comment (ServiceNow comment field: sys_created_by).",
            "type": "string"
          },
          "comment": {
            "description": "The text of the comment (ServiceNow comment field: value).",
            "type": "string"
          },
          "created": {
            "description": "The date and time the comment was created (ServiceNow comment field: sys_created_on).",
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "caseNumber",
          "customer",
          "id",
          "partnerId",
          "type",
          "contact",
          "comment",
          "created"
        ]
      },
      "webhook_secret_version": {
        "title": "Webhook Secret Version",
        "description": "Webhook authentication secret version reference used in webhook and event log responses.",
        "nullable": true,
        "type": "object",
        "properties": {
          "type": {
            "description": "The type of secret.",
            "type": "string",
            "enum": [
              "basic",
              "bearer",
              "header",
              "list"
            ],
            "example": "bearer"
          },
          "version": {
            "description": "The version of the webhook secret.",
            "type": "string",
            "example": "a1b2c3d4e5f64f7f8a9b0c1d2e3f4a5b"
          }
        }
      },
      "webhook_auth_basic": {
        "title": "Webhook Basic Auth",
        "description": "Basic authentication for a webhook.",
        "type": "object",
        "properties": {
          "type": {
            "description": "The type of secret (always \"basic\").",
            "type": "string",
            "enum": [
              "basic"
            ],
            "default": "basic"
          },
          "username": {
            "description": "The username for basic authentication.",
            "type": "string",
            "example": "my-service-user"
          },
          "password": {
            "description": "The password for basic authentication.",
            "type": "string",
            "format": "password",
            "example": "s3cr3t-p@ssw0rd"
          }
        }
      },
      "webhook_auth_bearer": {
        "title": "Webhook Bearer Auth",
        "description": "Bearer token authentication for a webhook.",
        "type": "object",
        "properties": {
          "type": {
            "description": "The type of secret (always \"bearer\").",
            "type": "string",
            "enum": [
              "bearer"
            ],
            "default": "bearer"
          },
          "token": {
            "description": "The bearer token.",
            "type": "string",
            "format": "password",
            "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
          }
        }
      },
      "webhook_auth_header": {
        "title": "Webhook Header Auth",
        "description": "Custom header authentication for a webhook.",
        "type": "object",
        "properties": {
          "type": {
            "description": "The type of secret (always \"header\").",
            "type": "string",
            "enum": [
              "header"
            ],
            "default": "header"
          },
          "name": {
            "description": "The name of the header.",
            "type": "string",
            "example": "X-API-Key"
          },
          "value": {
            "description": "The value of the header.",
            "type": "string",
            "format": "password",
            "example": "my-secret-api-key"
          }
        }
      },
      "webhook_auth_list": {
        "title": "Webhook Auth List",
        "description": "Multiple authentication methods for a webhook.",
        "type": "object",
        "properties": {
          "type": {
            "description": "The type of secret (always \"list\").",
            "type": "string",
            "enum": [
              "list"
            ],
            "default": "list"
          },
          "auth": {
            "description": "The list of authentication methods.",
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/webhook_auth_basic"
                },
                {
                  "$ref": "#/components/schemas/webhook_auth_bearer"
                },
                {
                  "$ref": "#/components/schemas/webhook_auth_header"
                }
              ]
            },
            "example": [
              {
                "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
                "type": "bearer"
              }
            ]
          }
        }
      },
      "webhook": {
        "title": "Webhook",
        "x-tags": [
          "Resources"
        ],
        "description": "A webhook that is triggered by events in the Care API.",
        "type": "object",
        "properties": {
          "id": {
            "description": "The unique identifier of the webhook.",
            "type": "string",
            "example": "6825d2cf57918d1ca439bb5e"
          },
          "contracts": {
            "description": "The contracts that trigger the webhook (wildcards permitted).",
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "*"
            ]
          },
          "events": {
            "description": "The events that trigger the webhook (wildcards permitted).",
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "case.updated",
              "case.comment.created"
            ]
          },
          "url": {
            "description": "The callback URL of the webhook.",
            "type": "string",
            "format": "uri",
            "example": "https://example.com/webhooks/care"
          },
          "auth": {
            "$ref": "#/components/schemas/webhook_secret_version"
          },
          "created": {
            "description": "The date and time the webhook was created.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-15T10:30:00Z"
          },
          "updated": {
            "description": "The date and time the webhook was last updated.",
            "type": "string",
            "format": "date-time",
            "example": "2025-01-16T08:00:00Z"
          },
          "called": {
            "description": "The date and time the webhook was last called.",
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "example": null
          }
        }
      }
    },
    "requestBodies": {
      "create_admin_api_key": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "label": {
                  "description": "A human-readable label for the API key.",
                  "type": "string",
                  "minLength": 1,
                  "example": "Production key"
                },
                "scope": {
                  "description": "The authorization scope for the API key.",
                  "type": "string",
                  "enum": [
                    "admin",
                    "trigger",
                    "company"
                  ],
                  "example": "admin"
                },
                "scopeRef": {
                  "description": "Company id when scope is \"company\"; must be null for admin/trigger.",
                  "type": "integer",
                  "format": "int32",
                  "nullable": true,
                  "default": null,
                  "example": 12345
                },
                "expires": {
                  "description": "An optional expiry date and time. Set to null for no expiry.",
                  "type": "string",
                  "format": "date-time",
                  "nullable": true,
                  "default": null,
                  "example": "2027-01-01T00:00:00Z"
                }
              },
              "required": [
                "label",
                "scope"
              ]
            }
          }
        }
      },
      "create_admin_contract": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "company": {
                  "description": "The company associated with the contract.",
                  "type": "integer",
                  "format": "int32",
                  "example": 1001
                },
                "companyName": {
                  "description": "The name of the company (customer or partner) associated with the contract.",
                  "type": "string",
                  "example": "Acme Corp"
                },
                "customer": {
                  "description": "The customer code associated with the contract.",
                  "type": "string",
                  "example": "CUST-001"
                },
                "customerName": {
                  "description": "The name of the customer associated with the contract.",
                  "type": "string",
                  "example": "Acme Customer"
                },
                "customerAlias": {
                  "description": "A list of alternative customer identifiers.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [],
                  "example": [
                    "ALIAS-A",
                    "ALIAS-B"
                  ]
                },
                "externalId": {
                  "description": "The external unique identifier of the contract.",
                  "type": "string",
                  "nullable": true,
                  "default": null,
                  "example": "EXT-CON-001"
                }
              },
              "required": [
                "company",
                "companyName",
                "customer",
                "customerName"
              ]
            }
          }
        }
      },
      "update_admin_contract": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "companyName": {
                  "description": "The name of the company (customer or partner) associated with the contract.",
                  "type": "string",
                  "example": "Acme Corp"
                },
                "customer": {
                  "description": "The customer code associated with the contract.",
                  "type": "string",
                  "example": "CUST-001"
                },
                "customerName": {
                  "description": "The name of the customer associated with the contract.",
                  "type": "string",
                  "example": "Acme Customer"
                },
                "customerAlias": {
                  "description": "A list of alternative customer identifiers.",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "ALIAS-A",
                    "ALIAS-B"
                  ]
                },
                "externalId": {
                  "description": "The external unique identifier of the contract.",
                  "type": "string",
                  "nullable": true,
                  "example": "EXT-CON-001"
                }
              }
            }
          }
        }
      },
      "create_api_key": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "label": {
                  "description": "A human-readable label for the API key.",
                  "type": "string",
                  "minLength": 1,
                  "example": "Production key"
                },
                "expires": {
                  "description": "An optional expiry date and time. Set to null for no expiry.",
                  "type": "string",
                  "format": "date-time",
                  "nullable": true,
                  "default": null,
                  "example": "2027-01-01T00:00:00Z"
                }
              },
              "required": [
                "label"
              ]
            }
          }
        }
      },
      "update_api_key": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "label": {
                  "description": "A human-readable label for the API key.",
                  "type": "string",
                  "minLength": 1,
                  "example": "Production key"
                },
                "expires": {
                  "description": "An optional expiry date and time. Set to null to remove expiry.",
                  "type": "string",
                  "format": "date-time",
                  "nullable": true,
                  "example": "2027-01-01T00:00:00Z"
                }
              }
            }
          }
        }
      },
      "upload_case_attachment": {
        "required": true,
        "content": {
          "multipart/form-data": {
            "schema": {
              "type": "object",
              "properties": {
                "file": {
                  "description": "The file to upload.",
                  "type": "string",
                  "format": "binary"
                }
              },
              "required": [
                "file"
              ]
            }
          }
        }
      },
      "create_case_comment": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "type": {
                  "description": "The comment type.",
                  "type": "string",
                  "enum": [
                    "comment",
                    "partnerComment"
                  ],
                  "default": "comment",
                  "example": "comment"
                },
                "contact": {
                  "description": "The email address of the user who is creating the comment.",
                  "type": "string",
                  "format": "email",
                  "example": "user@example.com"
                },
                "comment": {
                  "description": "The comment text.",
                  "type": "string",
                  "minLength": 1,
                  "example": "This issue has been escalated to the network team."
                }
              },
              "required": [
                "contact",
                "comment"
              ]
            }
          }
        }
      },
      "create_case": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "externalId": {
                  "description": "The external unique identifier of the case.",
                  "type": "string",
                  "nullable": true,
                  "default": null,
                  "example": "EXT-12345"
                },
                "contract": {
                  "description": "The unique identifier of the contract associated with the case.",
                  "type": "string",
                  "example": "CON-001"
                },
                "priority": {
                  "description": "The priority of the case:\n  * `1` - Critical\n  * `2` - High\n  * `3` - Moderate\n  * `4` - Low\n",
                  "type": "integer",
                  "format": "int32",
                  "enum": [
                    1,
                    2,
                    3,
                    4
                  ],
                  "default": 4,
                  "example": 4
                },
                "classification": {
                  "description": "The pre-classification of the case.",
                  "type": "string",
                  "enum": [
                    "incident",
                    "change",
                    "problem"
                  ],
                  "nullable": true,
                  "example": "incident"
                },
                "contact": {
                  "description": "The contact email address on the case.",
                  "type": "string",
                  "format": "email",
                  "example": "user@example.com"
                },
                "shortDescription": {
                  "description": "A short description of the case.",
                  "type": "string",
                  "minLength": 1,
                  "example": "Server is unresponsive"
                },
                "description": {
                  "description": "A detailed description of the case.",
                  "type": "string",
                  "minLength": 1,
                  "example": "The production server has been unresponsive since 10:00 AM."
                },
                "watchList": {
                  "description": "A list of email addresses to notify when the case is updated.",
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "email"
                  },
                  "default": [],
                  "example": [
                    "watcher1@example.com",
                    "watcher2@example.com"
                  ]
                }
              },
              "required": [
                "contract",
                "contact",
                "shortDescription",
                "description"
              ]
            }
          }
        }
      },
      "update_case": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "externalId": {
                  "description": "The external unique identifier of the case.",
                  "type": "string",
                  "nullable": true,
                  "example": "EXT-12345"
                }
              }
            }
          }
        }
      },
      "update_contract": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "externalId": {
                  "description": "The external unique identifier of the contract.",
                  "type": "string",
                  "nullable": true,
                  "example": "EXT-CON-001"
                }
              }
            }
          }
        }
      },
      "mock_case_event": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/mock_case_event"
            }
          }
        }
      },
      "mock_case_updated_event": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/mock_case_updated_event"
            }
          }
        }
      },
      "mock_case_attachment_event": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/mock_case_attachment_event"
            }
          }
        }
      },
      "mock_case_comment_event": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/mock_case_comment_event"
            }
          }
        }
      },
      "create_webhook": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "contracts": {
                  "description": "The contracts that trigger the webhook (wildcards permitted).",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [
                    "*"
                  ],
                  "example": [
                    "*"
                  ]
                },
                "events": {
                  "description": "The events that trigger the webhook (wildcards permitted).",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "default": [
                    "*"
                  ],
                  "example": [
                    "case.updated",
                    "case.comment.created"
                  ]
                },
                "url": {
                  "description": "The callback URL of the webhook.",
                  "type": "string",
                  "format": "uri",
                  "example": "https://example.com/webhooks/care"
                },
                "auth": {
                  "description": "The authentication method(s) for the webhook.",
                  "type": "object",
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/webhook_auth_basic"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_bearer"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_header"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_list"
                    }
                  ],
                  "nullable": true,
                  "default": null,
                  "example": null
                }
              },
              "required": [
                "url"
              ]
            }
          }
        }
      },
      "update_webhook": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "contracts": {
                  "description": "The contracts that trigger the webhook (wildcards permitted).",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "*"
                  ]
                },
                "events": {
                  "description": "The events that trigger the webhook (wildcards permitted).",
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "case.updated"
                  ]
                },
                "url": {
                  "description": "The callback URL of the webhook.",
                  "type": "string",
                  "format": "uri",
                  "example": "https://example.com/webhooks/care"
                },
                "auth": {
                  "description": "The authentication method(s) for the webhook.",
                  "type": "object",
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/webhook_auth_basic"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_bearer"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_header"
                    },
                    {
                      "$ref": "#/components/schemas/webhook_auth_list"
                    }
                  ],
                  "nullable": true,
                  "example": null
                }
              }
            }
          }
        }
      }
    },
    "responses": {
      "error_400": {
        "description": "An error occurred due to a bad request.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "error_403": {
        "description": "An error occurred due to a forbidden request.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "error_404": {
        "description": "An error occurred due to a resource not found.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "error_409": {
        "description": "An error occurred due to a conflict.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "error_422": {
        "description": "An error occurred due to unprocessable content.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "error_500": {
        "description": "An error occurred due to an internal server error.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "errors": {
                  "description": "A list of errors that occurred.",
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/error"
                  }
                }
              }
            }
          }
        }
      },
      "list_admin_api_keys": {
        "description": "The requested list of API keys.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/admin_api_key"
                  }
                }
              }
            }
          }
        }
      },
      "get_admin_api_key": {
        "description": "The requested API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_api_key"
                }
              }
            }
          }
        }
      },
      "create_admin_api_key": {
        "description": "The created API key with the raw key value (shown only once).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_api_key_secret"
                }
              }
            }
          }
        }
      },
      "update_admin_api_key": {
        "description": "The updated API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_api_key"
                }
              }
            }
          }
        }
      },
      "revoke_admin_api_key": {
        "description": "The revoked API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_api_key"
                }
              }
            }
          }
        }
      },
      "delete_admin_api_key": {
        "description": "API key permanently deleted."
      },
      "list_admin_contracts": {
        "description": "The requested list of contracts.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/admin_contract"
                  }
                }
              }
            }
          }
        }
      },
      "get_admin_contract": {
        "description": "The requested contract.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_contract"
                }
              }
            }
          }
        }
      },
      "create_admin_contract": {
        "description": "The created contract.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_contract"
                }
              }
            }
          }
        }
      },
      "update_admin_contract": {
        "description": "The updated contract.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/admin_contract"
                }
              }
            }
          }
        }
      },
      "list_api_keys": {
        "description": "The requested list of API keys.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/api_key"
                  }
                }
              }
            }
          }
        }
      },
      "get_api_key": {
        "description": "The requested API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/api_key"
                }
              }
            }
          }
        }
      },
      "create_api_key": {
        "description": "The created API key with the raw key value (shown only once).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/api_key_secret"
                }
              }
            }
          }
        }
      },
      "update_api_key": {
        "description": "The updated API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/api_key"
                }
              }
            }
          }
        }
      },
      "revoke_api_key": {
        "description": "The revoked API key.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/api_key"
                }
              }
            }
          }
        }
      },
      "list_case_attachments": {
        "description": "The requested list of case attachments.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/case_attachment"
                  }
                }
              }
            }
          }
        }
      },
      "get_case_attachment": {
        "description": "The requested case attachment.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case_attachment"
                }
              }
            }
          }
        }
      },
      "upload_case_attachment": {
        "description": "The uploaded attachment.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case_attachment"
                }
              }
            }
          }
        }
      },
      "download_case_attachment": {
        "description": "A stream containing the attachment data.",
        "content": {
          "application/octet-stream": {
            "schema": {
              "type": "string",
              "format": "binary"
            }
          }
        }
      },
      "list_case_comments": {
        "description": "The requested list of case comments.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/case_comment"
                  }
                }
              }
            }
          }
        }
      },
      "get_case_comment": {
        "description": "The requested case comment.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case_comment"
                }
              }
            }
          }
        }
      },
      "create_case_comment": {
        "description": "The created case comment.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case_comment"
                }
              }
            }
          }
        }
      },
      "list_cases": {
        "description": "The requested list of cases.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/case"
                  }
                }
              }
            }
          }
        }
      },
      "get_case": {
        "description": "The requested case.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case"
                }
              }
            }
          }
        }
      },
      "create_case": {
        "description": "The created case.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case"
                }
              }
            }
          }
        }
      },
      "update_case": {
        "description": "The updated case.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/case"
                }
              }
            }
          }
        }
      },
      "list_contracts": {
        "description": "The requested list of contracts.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/contract"
                  }
                }
              }
            }
          }
        }
      },
      "get_contract": {
        "description": "The requested contract.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/contract"
                }
              }
            }
          }
        }
      },
      "update_contract": {
        "description": "The updated contract.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/contract"
                }
              }
            }
          }
        }
      },
      "list_events": {
        "description": "The requested list of event log entries.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/event"
                  }
                }
              }
            }
          }
        }
      },
      "get_event": {
        "description": "The requested event log entry.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/event"
                }
              }
            }
          }
        }
      },
      "mock_event": {
        "description": "The generated event log entries.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/event"
                  }
                }
              }
            }
          }
        }
      },
      "list_webhooks": {
        "description": "The requested list of webhooks.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_page"
                },
                "data": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/webhook"
                  }
                }
              }
            }
          }
        }
      },
      "get_webhook": {
        "description": "The requested webhook.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/webhook"
                }
              }
            }
          }
        }
      },
      "create_webhook": {
        "description": "The created webhook.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/webhook"
                }
              }
            }
          }
        }
      },
      "update_webhook": {
        "description": "The updated webhook.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "meta": {
                  "$ref": "#/components/schemas/meta_empty"
                },
                "data": {
                  "$ref": "#/components/schemas/webhook"
                }
              }
            }
          }
        }
      },
      "delete_webhook": {
        "description": "Webhook successfully deleted."
      }
    }
  },
  "paths": {
    "/apikeys": {
      "get": {
        "operationId": "apikey-list",
        "tags": [
          "API Keys"
        ],
        "summary": "List API Keys",
        "description": "Get a paginated list of API keys for the authenticated account's company.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_api_keys"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "apikey-create",
        "tags": [
          "API Keys"
        ],
        "summary": "Create API Key",
        "description": "Create a new company-scoped API key for the authenticated account.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_api_key"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_api_key"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/apikeys/{keyId}": {
      "get": {
        "operationId": "apikey-get",
        "tags": [
          "API Keys"
        ],
        "summary": "Get API Key",
        "description": "Get an API key by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_api_key"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "apikey-update",
        "tags": [
          "API Keys"
        ],
        "summary": "Update API Key",
        "description": "Update an API key's label and/or expiry.",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_api_key"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_api_key"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "delete": {
        "operationId": "apikey-revoke",
        "tags": [
          "API Keys"
        ],
        "summary": "Revoke API Key",
        "description": "Revoke an API key (soft-delete by setting revoked timestamp).",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/revoke_api_key"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}/attachments": {
      "get": {
        "operationId": "case-attachment-list",
        "tags": [
          "Case Attachments"
        ],
        "summary": "List Case Attachments",
        "description": "Get a list of case attachments.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_case_attachments"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "case-attachment-upload",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Upload Case Attachment",
        "description": "Upload a new attachment to a case.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/upload_case_attachment"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/upload_case_attachment"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}/attachments/{attachmentId}": {
      "get": {
        "operationId": "case-attachment-get",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Get Case Attachment",
        "description": "Get a case attachment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/attachment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case_attachment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}/attachments/{attachmentId}/download": {
      "get": {
        "operationId": "case-attachment-download",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Download Case Attachment",
        "description": "Download an attachment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/attachment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/download_case_attachment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}/comments": {
      "get": {
        "operationId": "case-comment-list",
        "tags": [
          "Case Comments"
        ],
        "summary": "List Case Comments",
        "description": "Get a list of case comments.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_case_comments"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "case-comment-create",
        "tags": [
          "Case Comments"
        ],
        "summary": "Create Case Comment",
        "description": "Create a new case comment.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/create_case_comment"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_case_comment"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}/comments/{commentId}": {
      "get": {
        "operationId": "case-comment-get",
        "tags": [
          "Case Comments"
        ],
        "summary": "Get Case Comment",
        "description": "Get a case comment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/comment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case_comment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases": {
      "get": {
        "operationId": "case-list",
        "tags": [
          "Cases"
        ],
        "summary": "List Cases",
        "description": "Get a list of cases.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_cases"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "case-create",
        "tags": [
          "Cases"
        ],
        "summary": "Create Case",
        "description": "Create a new case.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_case"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_case"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/cases/{caseId}": {
      "get": {
        "operationId": "case-get",
        "tags": [
          "Cases"
        ],
        "summary": "Get Case",
        "description": "Get a case by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "case-update",
        "tags": [
          "Cases"
        ],
        "summary": "Update Case",
        "description": "Update a case by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_case"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_case"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/contracts": {
      "get": {
        "operationId": "contract-list",
        "tags": [
          "Contracts"
        ],
        "summary": "List Contracts",
        "description": "Get a list of contracts.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_contracts"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/contracts/{contractId}": {
      "get": {
        "operationId": "contract-get",
        "tags": [
          "Contracts"
        ],
        "summary": "Get Contract",
        "description": "Get a contract by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/contract_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_contract"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "contract-update",
        "tags": [
          "Contracts"
        ],
        "summary": "Update Contract",
        "description": "Update a contract by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/contract_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_contract"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_contract"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/events": {
      "get": {
        "operationId": "event-list",
        "tags": [
          "Event Logs"
        ],
        "summary": "List Events",
        "description": "Get a paginated list of event log entries.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_events"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/events/{eventId}": {
      "get": {
        "operationId": "event-get",
        "tags": [
          "Event Logs"
        ],
        "summary": "Get Event",
        "description": "Get an event log entry by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/event_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_event"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/webhooks": {
      "get": {
        "operationId": "webhook-list",
        "tags": [
          "Webhooks"
        ],
        "summary": "List Webhooks",
        "description": "Get a paginated list of webhook subscriptions.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_webhooks"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "webhook-create",
        "tags": [
          "Webhooks"
        ],
        "summary": "Create Webhook",
        "description": "Create a new webhook subscription.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_webhook"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_webhook"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/webhooks/{webhookId}": {
      "get": {
        "operationId": "webhook-get",
        "tags": [
          "Webhooks"
        ],
        "summary": "Get Webhook",
        "description": "Get a webhook subscription by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_webhook"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "webhook-update",
        "tags": [
          "Webhooks"
        ],
        "summary": "Update Webhook",
        "description": "Update an existing webhook subscription.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_webhook"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_webhook"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "delete": {
        "operationId": "webhook-delete",
        "tags": [
          "Webhooks"
        ],
        "summary": "Delete Webhook",
        "description": "Delete a webhook subscription by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "responses": {
          "204": {
            "$ref": "#/components/responses/delete_webhook"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/apikeys": {
      "get": {
        "operationId": "sandbox-apikey-list",
        "tags": [
          "API Keys"
        ],
        "summary": "Sandbox - List API Keys",
        "description": "Get a paginated list of API keys for the authenticated account's company.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_api_keys"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "sandbox-apikey-create",
        "tags": [
          "API Keys"
        ],
        "summary": "Sandbox - Create API Key",
        "description": "Create a new company-scoped API key for the authenticated account.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_api_key"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_api_key"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/apikeys/{keyId}": {
      "get": {
        "operationId": "sandbox-apikey-get",
        "tags": [
          "API Keys"
        ],
        "summary": "Sandbox - Get API Key",
        "description": "Get an API key by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_api_key"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "sandbox-apikey-update",
        "tags": [
          "API Keys"
        ],
        "summary": "Sandbox - Update API Key",
        "description": "Update an API key's label and/or expiry.",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_api_key"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_api_key"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "delete": {
        "operationId": "sandbox-apikey-revoke",
        "tags": [
          "API Keys"
        ],
        "summary": "Sandbox - Revoke API Key",
        "description": "Revoke an API key (soft-delete by setting revoked timestamp).",
        "parameters": [
          {
            "$ref": "#/components/parameters/key_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/revoke_api_key"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}/attachments": {
      "get": {
        "operationId": "sandbox-case-attachment-list",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Sandbox - List Case Attachments",
        "description": "Get a list of case attachments.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_case_attachments"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "sandbox-case-attachment-upload",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Sandbox - Upload Case Attachment",
        "description": "Upload a new attachment to a case.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/upload_case_attachment"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/upload_case_attachment"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}/attachments/{attachmentId}": {
      "get": {
        "operationId": "sandbox-case-attachment-get",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Sandbox - Get Case Attachment",
        "description": "Get a case attachment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/attachment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case_attachment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}/attachments/{attachmentId}/download": {
      "get": {
        "operationId": "sandbox-case-attachment-download",
        "tags": [
          "Case Attachments"
        ],
        "summary": "Sandbox - Download Case Attachment",
        "description": "Download an attachment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/attachment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/download_case_attachment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}/comments": {
      "get": {
        "operationId": "sandbox-case-comment-list",
        "tags": [
          "Case Comments"
        ],
        "summary": "Sandbox - List Case Comments",
        "description": "Get a list of case comments.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_case_comments"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "sandbox-case-comment-create",
        "tags": [
          "Case Comments"
        ],
        "summary": "Sandbox - Create Case Comment",
        "description": "Create a new case comment.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/create_case_comment"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_case_comment"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}/comments/{commentId}": {
      "get": {
        "operationId": "sandbox-case-comment-get",
        "tags": [
          "Case Comments"
        ],
        "summary": "Sandbox - Get Case Comment",
        "description": "Get a case comment by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          },
          {
            "$ref": "#/components/parameters/comment_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case_comment"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases": {
      "get": {
        "operationId": "sandbox-case-list",
        "tags": [
          "Cases"
        ],
        "summary": "Sandbox - List Cases",
        "description": "Get a list of cases.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_cases"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "sandbox-case-create",
        "tags": [
          "Cases"
        ],
        "summary": "Sandbox - Create Case",
        "description": "Create a new case.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_case"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_case"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/cases/{caseId}": {
      "get": {
        "operationId": "sandbox-case-get",
        "tags": [
          "Cases"
        ],
        "summary": "Sandbox - Get Case",
        "description": "Get a case by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_case"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "sandbox-case-update",
        "tags": [
          "Cases"
        ],
        "summary": "Sandbox - Update Case",
        "description": "Update a case by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/case_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_case"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_case"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/contracts": {
      "get": {
        "operationId": "sandbox-contract-list",
        "tags": [
          "Contracts"
        ],
        "summary": "Sandbox - List Contracts",
        "description": "Get a list of contracts.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_contracts"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/contracts/{contractId}": {
      "get": {
        "operationId": "sandbox-contract-get",
        "tags": [
          "Contracts"
        ],
        "summary": "Sandbox - Get Contract",
        "description": "Get a contract by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/contract_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_contract"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "sandbox-contract-update",
        "tags": [
          "Contracts"
        ],
        "summary": "Sandbox - Update Contract",
        "description": "Update a contract by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/contract_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_contract"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_contract"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events": {
      "get": {
        "operationId": "sandbox-event-list",
        "tags": [
          "Event Logs"
        ],
        "summary": "Sandbox - List Events",
        "description": "Get a paginated list of event log entries.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_events"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/{eventId}": {
      "get": {
        "operationId": "sandbox-event-get",
        "tags": [
          "Event Logs"
        ],
        "summary": "Sandbox - Get Event",
        "description": "Get an event log entry by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/event_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_event"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/case.contract.assigned": {
      "post": {
        "operationId": "sandbox-event-trigger-case-contract-assigned",
        "tags": [
          "Event Triggers"
        ],
        "summary": "Sandbox - Trigger case.contract.assigned",
        "description": "Trigger a case.contract.assigned event for testing purposes.",
        "requestBody": {
          "$ref": "#/components/requestBodies/mock_case_event"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/mock_event"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/case.contract.unassigned": {
      "post": {
        "operationId": "sandbox-event-trigger-case-contract-unassigned",
        "tags": [
          "Event Triggers"
        ],
        "summary": "Sandbox - Trigger case.contract.unassigned",
        "description": "Trigger a case.contract.unassigned event for testing purposes.",
        "requestBody": {
          "$ref": "#/components/requestBodies/mock_case_event"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/mock_event"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/case.updated": {
      "post": {
        "operationId": "sandbox-event-trigger-case-updated",
        "tags": [
          "Event Triggers"
        ],
        "summary": "Sandbox - Trigger case.updated",
        "description": "Trigger a case.updated event for testing purposes.",
        "requestBody": {
          "$ref": "#/components/requestBodies/mock_case_updated_event"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/mock_event"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/case.attachment.created": {
      "post": {
        "operationId": "sandbox-event-trigger-case-attachment-created",
        "tags": [
          "Event Triggers"
        ],
        "summary": "Sandbox - Trigger case.attachment.created",
        "description": "Trigger a case.attachment.created event for testing purposes.",
        "requestBody": {
          "$ref": "#/components/requestBodies/mock_case_attachment_event"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/mock_event"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/events/case.comment.created": {
      "post": {
        "operationId": "sandbox-event-trigger-case-comment-created",
        "tags": [
          "Event Triggers"
        ],
        "summary": "Sandbox - Trigger case.comment.created",
        "description": "Trigger a case.comment.created event for testing purposes.",
        "requestBody": {
          "$ref": "#/components/requestBodies/mock_case_comment_event"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/mock_event"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/webhooks": {
      "get": {
        "operationId": "sandbox-webhook-list",
        "tags": [
          "Webhooks"
        ],
        "summary": "Sandbox - List Webhooks",
        "description": "Get a paginated list of webhook subscriptions.",
        "responses": {
          "200": {
            "$ref": "#/components/responses/list_webhooks"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "post": {
        "operationId": "sandbox-webhook-create",
        "tags": [
          "Webhooks"
        ],
        "summary": "Sandbox - Create Webhook",
        "description": "Create a new webhook subscription.",
        "requestBody": {
          "$ref": "#/components/requestBodies/create_webhook"
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/create_webhook"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    },
    "/sandbox/webhooks/{webhookId}": {
      "get": {
        "operationId": "sandbox-webhook-get",
        "tags": [
          "Webhooks"
        ],
        "summary": "Sandbox - Get Webhook",
        "description": "Get a webhook subscription by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/get_webhook"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_WRITE"
            ]
          }
        ]
      },
      "patch": {
        "operationId": "sandbox-webhook-update",
        "tags": [
          "Webhooks"
        ],
        "summary": "Sandbox - Update Webhook",
        "description": "Update an existing webhook subscription.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/update_webhook"
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/update_webhook"
          },
          "400": {
            "$ref": "#/components/responses/error_400"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "409": {
            "$ref": "#/components/responses/error_409"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      },
      "delete": {
        "operationId": "sandbox-webhook-delete",
        "tags": [
          "Webhooks"
        ],
        "summary": "Sandbox - Delete Webhook",
        "description": "Delete a webhook subscription by ID.",
        "parameters": [
          {
            "$ref": "#/components/parameters/webhook_id"
          }
        ],
        "responses": {
          "204": {
            "$ref": "#/components/responses/delete_webhook"
          },
          "403": {
            "$ref": "#/components/responses/error_403"
          },
          "404": {
            "$ref": "#/components/responses/error_404"
          },
          "422": {
            "$ref": "#/components/responses/error_422"
          },
          "500": {
            "$ref": "#/components/responses/error_500"
          }
        },
        "security": [
          {
            "ArxusSSO": [
              "ROLE_ITSM_SANDBOX_WRITE"
            ]
          }
        ]
      }
    }
  }
}