Skip to main content
POST
Proxy AI Request

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Headers

x-veryfront-agent-run-id
string

Durable run ID. Required for run-bound service-account credentials.

Required string length: 1 - 245
x-veryfront-conversation-id
string

Durable conversation ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-message-id
string

Durable message ID. Required with agent run attribution.

Required string length: 1 - 255
x-veryfront-project-id
string

Project ID used to validate durable run attribution.

Required string length: 1 - 255
x-veryfront-agent-id
string

Agent ID. Must match the authenticated run-bound credential.

Required string length: 1 - 255
x-veryfront-billing-group-id
string

Optional billing group. Run requests are pinned to agent-run:.

Required string length: 1 - 255

Path Parameters

provider
enum<string>
required

Provider.

Available options:
anthropic,
openai,
google,
mistral,
moonshotai
Example:

"anthropic"

path
string
required

Provider path.

Example:

"v1/messages"

Body

application/json

Provider-specific request body (forwarded as-is to upstream)

{key}
unknown

Response

Upstream provider response (forwarded as-is)