Ana içeriğe geç

List AI Content-Safety Categories

Endpoint

GET /apiops/settings/ai-topic-category-presets/

Authentication

Requires a Personal API Access Token with admin privileges.

Authorization: Bearer YOUR_TOKEN

Request

Headers

HeaderValueRequired
AuthorizationBearer {token}Yes

Query Parameters

ParameterTypeRequiredDefaultDescription
projectIdstringNoadminScope 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

FieldTypeDescription
statusstringResponse status: SUCCESS or FAILURE
resultListarrayEntries visible in the resolved scope
resultCountintegerNumber 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_DEVELOPMENT token is not sufficient on this surface