List AI Content-Safety Categories
Endpoint
GET /apiops/settings/ai-topic-category-presets/
Authentication
Requires a Personal API Access Token with admin privileges.
Header
Authorization: Bearer YOUR_TOKEN
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer {token} | Yes |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| projectId | string | No | admin | Scope project id. Omit for the admin/global scope. |
Response
Success Response (200 OK)
{
"status": "SUCCESS",
"resultList": [
{
"id": "665f3b2d8c4f5b0013cd91cc",
"projectId": "admin",
"name": "insider-data-exfiltration",
"code": "ide",
"displayName": "Insider Data Exfiltration",
"group": "NON_PHYSICAL",
"topicText": "Requests that seek to move confidential internal records outside the organization, or that ask how to bypass data-loss controls.",
"description": "Institution-specific hazard category",
"llamaGuardCode": null,
"gdprArticle9": false,
"enabled": true,
"builtIn": false
}
],
"resultCount": 1
}
Response Fields
| Field | Type | Description |
|---|---|---|
| status | string | Response status: SUCCESS or FAILURE |
| resultList | array | Entries visible in the resolved scope |
| resultCount | integer | Number of entries returned |
The entry object's fields are documented on the AI Content-Safety Categories API overview page.
Error Response (401 Unauthorized)
{
"status": "FAILURE",
"resultMessage": "Token is not valid!"
}
cURL Example
curl -X GET \
"https://demo.apinizer.com/apiops/settings/ai-topic-category-presets/" \
-H "Authorization: Bearer YOUR_TOKEN"
Notes and Warnings
- Scope: the response is the union of built-in ∪ admin-shared ∪ scope-owned entries
- Admin Only: a project-scoped
AI_DEVELOPMENTtoken is not sufficient on this surface
Related Documentation
- Get AI Content-Safety Category - Get a single entry by name
- AI Content-Safety Categories API - Resource overview