# Kb - X-Radius API

> Base URL: https://x-radius.com/api/v1
> Auth: Authorization: Bearer xrt_...  (a manager API token)
> Envelope: {"data": ...}; lists add {"meta":{page,page_size,total,has_next}}
> Errors: {"error":{"code","message","request_id"}} - branch on code, never on message
> Timestamps: yyyy-MM-dd HH:mm:ss, UTC
> Money: a bare JSON number in major units, with an ISO-4217 currency code beside it
> Idempotency: redeem and activate endpoints take a client-supplied request_id (UUID)
>
> This page: https://x-radius.com/docs/api/kb
> Every group: https://x-radius.com/llms.txt

28 endpoints in 1 resource groups. 0 carry a hand-written reference entry with examples; the remaining 28 are generated from the running router and carry method, path, authentication, permission and rate-limit bucket, but no request or response example.

### View the knowledge base & self-service insights

`GET /api/v1/kb/articles`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/bulk-archive`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/bulk-delete`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/bulk-publish`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/bulk-unpublish`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`DELETE /api/v1/kb/articles/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/articles/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`PATCH /api/v1/kb/articles/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/{id}/attach`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`DELETE /api/v1/kb/articles/{id}/attachments/{attId}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/articles/{id}/attachments/{attId}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/articles/{id}/versions`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/articles/{id}/versions/{version}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/articles/{id}/versions/{version}/restore`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/categories`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/categories`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`DELETE /api/v1/kb/categories/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`PATCH /api/v1/kb/categories/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/insights`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/search`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/ticket-categories`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/wizards`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/wizards`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`POST /api/v1/kb/wizards/bulk-delete`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`DELETE /api/v1/kb/wizards/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### View the knowledge base & self-service insights

`GET /api/v1/kb/wizards/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_view` (View the knowledge base & self-service insights)
- Risk: read

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


### Author knowledge base articles & troubleshooting guides

`PATCH /api/v1/kb/wizards/{id}`

- Authentication: manager session (JWT) or API token
- Permission: `prm_kb_manage` (Author knowledge base articles & troubleshooting guides)
- Risk: write
- Rate limit bucket: `t_mutate`

_This endpoint has no hand-written reference entry yet. The method, path, authentication, permission and rate limit above are generated from the running router and are accurate; there is no request or response example._


