> ## Documentation Index > Fetch the complete documentation index at: https://docs.talqui.chat/llms.txt > Use this file to discover all available pages before exploring further. # Get public category > Category page: the category, its published articles and its siblings. The only input read from the request is `:slug`. The category is looked up as the pair `(resolved helpdeskID, slug)` — never by slug alone, since `getting-started` exists in most help centers and a global lookup would answer with whichever tenant's document the index reached first. ## OpenAPI ````yaml /api/helpdesk.yaml get /v1/public/categories/{slug} openapi: 3.0.3 info: description: >- Help center API for the Talqui Helpdesk plugin. Two surfaces with different audiences: authenticated authoring routes under /v1/tenants/:tenantID, and anonymous public reads under /v1/public resolved from the request hostname. license: name: ISC url: https://opensource.org/license/isc-license-txt title: Talqui Helpdesk API version: 0.9.0 servers: - description: Production url: https://plugins-api.talqui.chat/helpdesk security: [] tags: - name: Install - name: Public - name: Helpdesk - name: Categories - name: Articles paths: /v1/public/categories/{slug}: get: tags: - Public summary: Get public category description: >- Category page: the category, its published articles and its siblings. The only input read from the request is `:slug`. The category is looked up as the pair `(resolved helpdeskID, slug)` — never by slug alone, since `getting-started` exists in most help centers and a global lookup would answer with whichever tenant's document the index reached first. operationId: GetPublicCategoryController parameters: - in: path name: slug required: true schema: maxLength: 160 minLength: 1 pattern: ^[a-z0-9][a-z0-9-]*$ type: string responses: '200': content: application/json: schema: additionalProperties: false properties: articles: items: additionalProperties: false properties: articleDescription: type: string articleFeatured: type: boolean articleID: type: string articleOrder: type: number articleSlug: type: string articleTitle: type: string categoryID: type: string publishedAt: format: date-time nullable: true pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ type: string required: - articleID - categoryID - articleSlug - articleTitle - articleDescription - articleOrder - articleFeatured - publishedAt type: object type: array category: additionalProperties: false properties: categoryArticleCount: type: number categoryDescription: type: string categoryID: type: string categoryIconUrl: nullable: true type: string categoryOrder: type: number categorySlug: type: string categoryTitle: type: string required: - categoryID - categorySlug - categoryTitle - categoryDescription - categoryIconUrl - categoryOrder - categoryArticleCount type: object helpdesk: additionalProperties: false properties: helpdeskHostnames: items: type: string type: array helpdeskID: type: string helpdeskLocale: type: string helpdeskName: type: string helpdeskSlug: nullable: true type: string helpdeskStatus: enum: - draft - published type: string helpdeskSupport: additionalProperties: false properties: chatEnabled: type: boolean emailAddress: nullable: true type: string websiteUrl: nullable: true type: string required: - chatEnabled - emailAddress - websiteUrl type: object helpdeskTheme: additionalProperties: false properties: colorHeaderBackground: nullable: true type: string colorLoading: nullable: true type: string colorPrimary: nullable: true type: string faviconUrl: nullable: true type: string headerTitle: nullable: true type: string logoUrl: nullable: true type: string required: - colorPrimary - colorHeaderBackground - colorLoading - logoUrl - faviconUrl - headerTitle type: object required: - helpdeskID - helpdeskName - helpdeskSlug - helpdeskLocale - helpdeskStatus - helpdeskTheme - helpdeskSupport - helpdeskHostnames type: object siblingCategories: items: additionalProperties: false properties: categoryArticleCount: type: number categoryDescription: type: string categoryID: type: string categoryIconUrl: nullable: true type: string categoryOrder: type: number categorySlug: type: string categoryTitle: type: string required: - categoryID - categorySlug - categoryTitle - categoryDescription - categoryIconUrl - categoryOrder - categoryArticleCount type: object type: array required: - helpdesk - category - articles - siblingCategories type: object description: Response for status 200. '400': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/MissingHelpdeskHostnameError' - $ref: '#/components/schemas/RequestValidationError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- MissingHelpdeskHostnameError (error_code 1106): no hostname on the request. | RequestValidationError (error_code 1002): the slug is not a valid slug. '404': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/HelpdeskNotFoundError' - $ref: '#/components/schemas/CategoryNotFoundError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- HelpdeskNotFoundError (error_code 1107): the hostname maps to no help center. | CategoryNotFoundError (error_code 1108): no published category with this slug here. '500': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/UnknownError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- UnknownError (error_code 5999): Unexpected internal error not otherwise documented for this endpoint. components: schemas: MissingHelpdeskHostnameError: additionalProperties: false properties: error: enum: - MissingHelpdeskHostnameError type: string error_code: enum: - 1106 type: number message: example: The X-Helpdesk-Host header is required. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message type: object RequestValidationError: additionalProperties: false properties: error: enum: - RequestValidationError type: string error_code: enum: - 1002 type: number fields: items: additionalProperties: false properties: allowed: type: string field: type: string received: type: string required: - field - received - allowed type: object type: array message: example: Invalid request data. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message - fields type: object HelpdeskNotFoundError: additionalProperties: false properties: error: enum: - HelpdeskNotFoundError type: string error_code: enum: - 1107 type: number message: example: No help center answers on this address. type: string statusCode: enum: - 404 type: number required: - statusCode - error - error_code - message type: object CategoryNotFoundError: additionalProperties: false properties: error: enum: - CategoryNotFoundError type: string error_code: enum: - 1108 type: number message: example: Category not found. type: string statusCode: enum: - 404 type: number required: - statusCode - error - error_code - message type: object UnknownError: additionalProperties: false properties: error: enum: - UnknownError type: string error_code: enum: - 5999 type: number message: example: For some unknown reason your request has not succeeded. type: string statusCode: enum: - 500 type: number required: - statusCode - error - error_code - message type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.