--- updatedAt: 2025-08-14T13:36:49.000Z agentTools: siteIndex: https://developer.n-able.com/llms.txt projectIndex: https://developer.n-able.com/n-central/llms.txt --- # PREVIEW: Retrieve detailed information for a specific Custom PSA Ticket by ID. Retrieves detailed information for a specific Custom PSA Ticket. The endpoint is exclusive to CUSTOM PSA Integrations, NOT for ConnectWise, AutoTask, TigerPaw or other managed PSAs.
NOTE:This endpoint is currently in a preview stage. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "N-central API-Service", "description": "

API Access

\n

In order to use the API-Service endpoints, ensure the following prerequisites are met:

\n
    \n
  1. User is created in N-central with appropriate permissions and configuration\n (roles, access groups, MFA disabled, 2FA disabled).
    2. \n
  2. API access is set up in N-central by having a JWT\n (Json Web Token, referred to as \"N-central User-API Token\") generated,\n acting as the permanent secret solely used for fetching access and refresh tokens.
    3. \n
\n

To access the API-Service endpoints, the JWT must first be exchanged with access and refresh tokens:

\n\n

API Pagination & Sorting

\n

Certain API-Service query endpoints support pagination and sorting through the use of query parameters.

\n

Pagination query parameters:

\n\n

A paginated response contains several related fields, such as pageSize, pageNumber, itemCount, totalItems,\n totalPages, _links (first, last, previous and next pages) and _warning (containing any warning messages,\n if present).

\n

Sorting query parameters:

\n\n

API Rate Limiting

\n

The API-Service endpoints are rate limited to ensure the stability, availability and performance of\n the overall system.

\n

Upon reaching such a rate limit, the endpoints return HTTP Status 429 - Too Many Requests.

\n

The system will accept further requests once existing in-flight requests are completed.

\n", "version": "1.0" }, "servers": [ { "url": "https://{custom-server}/", "description": "Default Server URL" } ], "tags": [ { "name": "PSA", "description": "PSA operations" } ], "paths": { "/api/custom-psa/tickets/{customPsaTicketId}": { "post": { "tags": [ "PSA" ], "summary": "PREVIEW: Retrieve detailed information for a specific Custom PSA Ticket by ID.", "description": "Retrieves detailed information for a specific Custom PSA Ticket. The endpoint is exclusive to CUSTOM PSA Integrations, NOT for ConnectWise, AutoTask, TigerPaw or other managed PSAs.
NOTE:This endpoint is currently in a preview stage.", "operationId": "getCustomTicketInfo", "parameters": [ { "name": "customPsaTicketId", "in": "path", "description": "The unique identifier of the Custom PSA ticket to retrieve.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PsaCredentialRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful retrieval of the Custom PSA ticket information.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomPsaTicketGetResponse" } } } }, "400": { "description": "Invalid psaTicketId format.", "content": { "application/json": { "schema": { "type": "string", "example": { "status": 400, "message": "BAD REQUEST: InvalidInputFormatException: Invalid customPsaTicketId format: string." } } } } }, "401": { "description": "Authentication Failure.", "content": { "application/json": { "schema": { "type": "string", "example": { "status": 401, "message": "[ID=abcd] UNAUTHORIZED: UnauthorizedException: Missing authorization header bearer." } } } } }, "403": { "description": "Forbidden", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Not Found", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error.", "content": { "application/json": { "schema": { "type": "string", "example": { "status": 500, "message": "[ID=abcd] INTERNAL SERVER ERROR: UnexpectedDmsResponseException: Unexpected response from DMS: The DMS response indicates a non-success status code : 500." } } } } } }, "security": [ { "API-Access_Token": [] } ] } } }, "components": { "schemas": { "ErrorResponse": { "type": "object", "properties": { "status": { "type": "integer", "format": "int32" }, "message": { "type": "string" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ValidationError" } } }, "description": "Error response", "example": { "status": 400, "message": "[ID=2b85998f-26a3-467a] BAD REQUEST: InvalidInputFormatException: Invalid customerId format: 'null'." } }, "ValidationError": { "type": "object", "properties": { "field": { "type": "string" }, "message": { "type": "string" } } }, "PsaCredentialRequest": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "description": "Representation of PSA credentials.", "example": { "username": "username@domain.com", "password": "myPassword!" } }, "CustomPsaTicketGetResponse": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CustomPsaTicketInfo" }, "_links": { "type": "object", "additionalProperties": { "type": "string", "description": "Links to related endpoints." }, "description": "Links to related endpoints." } }, "description": "Represents the response for fetching details of a specific Custom PSA ticket.\n", "example": { "data": { "ticketId": "1142285696", "ticketTitle": "Foo bar ticket #1", "ticketDetails": "For testing PSA ticketing", "ticketStatus": "CREATE_TICKET_CREATED_IN_NCENTRAL", "creationDate": "2024-02-21T06:28:10.624-05:00[America/New_York]" }, "_links": {} } }, "CustomPsaTicketInfo": { "type": "object", "properties": { "ticketId": { "type": "string", "description": "The ID of the Custom PSA ticket." }, "ticketTitle": { "type": "string", "description": "The title of the Custom PSA ticket." }, "ticketDetails": { "type": "string", "description": "The details of the Custom PSA ticket." }, "ticketStatus": { "type": "string", "description": "The status of the Custom PSA ticket." }, "creationDate": { "type": "string", "description": "The creation date of the Custom PSA ticket." } }, "description": "Represents the response for fetching details of a specific Custom PSA ticket." } }, "securitySchemes": { "API-Access_Token": { "type": "http", "description": "Access token for API. You can get the token by authenticating. See \"POST - /api/auth/authenticate\".", "scheme": "bearer", "bearerFormat": "JWT" } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true } } ```