ReferenceAPI
Call a model from a host invocation
POST
/v1/hosts/{host_id}/modelAuthorization
hostToken AuthorizationBearer <token>
The scoped token returned by POST /v1/hosts, sent as Authorization: Bearer . Identifies this registered host; do not substitute the server API token.
In: header
Path Parameters
host_id*string
Match
^host_[A-Za-z0-9]{20,32}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/hosts/string/model" \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "request": { "messages": [ { "content": [ { "text": "string", "type": "text" } ], "role": "user" } ] }, "sequence": 1, "session_id": "string" }'{ "message": { "content": [ { "text": "string", "type": "text" } ], "role": "user" }, "stop_reason": "end_turn", "usage": { "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0, "input_tokens": 0, "output_tokens": 0, "provider_cost_usd": "string", "reasoning_tokens": 0, "total_input_tokens": 0 }}