conversation-routing

Get Routing Manifest

Return assembled routing manifests from all active agent types.

Queries all agent types for the organization and filters to those with conversation_routing configured, returning their routing rules. The tenant SurrealDB namespace keyed by the authenticated caller’s organization is the isolation boundary — the dependency on get_surrealdb_client resolves the right namespace through the auth chain.

Returns: RoutingManifest with entries for each eligible agent type.

GET

agents

routing-manifest

Get Routing Manifest

curl --request GET \
  --url https://api.example.com/agents/routing-manifest

{
  "entries": [
    {
      "agent_type_id": "<string>",
      "agent_type_name": "<string>",
      "when": "<string>",
      "examples": [
        "<string>"
      ],
      "avoid": "<string>"
    }
  ]
}

Response

200 - application/json

Successful Response

Assembled routing manifests from all active agent types with conversation routing.

Attributes: entries: List of routing manifest entries, one per eligible agent type.

entries

RoutingManifestEntry · object[]

required

Show child attributes

Send Instance MessageStream a message to a specific agent instance. Resolves the agent instance's runner URL and streams the SSE response back to the client. This is the second hop in the two-hop routing pattern. Agent instances, agent types, and agent resources all live in the tenant SurrealDB namespace; the dependency on ``get_surrealdb_client`` resolves the right namespace through the auth chain, and the namespace itself is the organization boundary. Returns: SSE stream of the agent's response. Raises: NotFoundError: If instance not found in this namespace. AgentInvokerError: If runner resolution or streaming fails.

Get Routing Manifest

curl --request GET \
  --url https://api.example.com/agents/routing-manifest

{
  "entries": [
    {
      "agent_type_id": "<string>",
      "agent_type_name": "<string>",
      "when": "<string>",
      "examples": [
        "<string>"
      ],
      "avoid": "<string>"
    }
  ]
}

Documentation Index

Response