VeristageDevelopers
Ai discovery

List AI tools available to this api-key

GET/ai/tools

Tools are filtered by the api-key's permissions. The defaults array shows which tools are enabled if you omit tools from a chat message body.

Authorization

apiKey
X-Api-Key<token>

Issued to you when your integration is provisioned. Determines which catalogue resources are visible and which AI tools are available.

In: header

Response Body

application/json

curl -X GET "https://example.com/ai/tools"
{  "data": {    "tools": [      {        "name": "internal_search",        "label": "string",        "description": "string",        "category": "string",        "default": true,        "requiresOptIn": true,        "costNote": "string"      }    ],    "defaults": [      "internal_search",      "vector_search",      "read_resource_fields",      "document_reading"    ]  }}

List system-prompt profiles GET

Named prompt profiles (e.g. "Editor", "Researcher") that can be passed as the `profile` body field on chat messages.

Fetch a generated artwork image GET

Streams an artwork image produced by `POST /ai/generate-artwork`. Unlike `GET /ai/images` (which browsers can call via a signed URL), artwork images sit outside the chat image tree, so this route is fetched with the `X-Api-Key` header and is scoped to the linked user's own artwork directory (`/filestore/artwork/{userId}/...`). Requires the `ai` key scope and a linked service user. Pass the `path` value returned by the generate-artwork response.