Skip to main content
GET
/
api
/
v1
/
engine
/
intents
Error
A valid request URL is required to generate request examples
{
  "intents": [
    {}
  ],
  "etag": "<string>",
  "cache_max_age_seconds": 123
}

Authorizations

​
Authorization
string
header
required

Deploy-wide server-to-server bearer token (ENGINE_API_TOKEN), validated by the engine_api firewall. Authenticates the Engine API, Knowledge base, and Conversions surfaces. The tenant_id rides in the request body and is trusted in V1 — keep this token strictly server-side.

Headers

​
If-None-Match
string

A previously-returned ETag. Yields 304 when the catalog is unchanged.

Query Parameters

​
tenant_id
string<uuid>
required

Response

Intent catalog

​
intents
object[]
required
​
etag
string
required

Weak validator; echo back in If-None-Match.

​
cache_max_age_seconds
integer
required

Suggested client cache lifetime (300).