Knowledge Base API
POST/api/v1/kb-articles/from-ticket/{ticketId}
Product availabilityAlgaPSAAlgaDesk

Create a KB article from a ticket

Creates a troubleshooting KB article (audience internal) from an existing ticket, seeding the body with the ticket title/description as a "Problem" section and the resolution as a "Resolution" section.

RBAC · document

Path parameters

ticketIdstring <uuid>Required
Source ticket UUID.

Response body

Success response 201 · schema KbArticleResponse

dataobjectRequired
A knowledge base article and its metadata.
article_idstring <uuid>Required
tenantstring <uuid>Required
document_idstring <uuid>Required
Underlying document backing the article.
titlestringRequired
slugstringRequired
article_typestringRequired
Enum: how_tofaqtroubleshootingreference
audiencestringRequired
Enum: internalclientpublic
statusstringRequired
Enum: draftreviewpublishedarchived
category_idstring <uuid>Nullable
review_cycle_daysintegerNullable
next_review_datestringNullable
published_atstringNullable
published_bystring <uuid>Nullable
document_namestringNullable
Joined from the documents table.
created_atstring
updated_atstring
metaobject

Response codes

201
Article created from the ticket.
400
Invalid request.
401
API key missing/invalid.
403
Caller lacks the required document permission.
404
Ticket not found.
500
Unexpected error.