POST /v1/messages

Part of the API reference; this page is generated from the OpenAPI document that the gateway builds from its own route tables.

Provenance

• Contract version: 1.10.0
• Contract title: acumen gateway API
• Source: acumen:docs/openapi/acumen-v1.openapi.json

Operations

POST /v1/messages

Anthropic Messages door

The Anthropic Messages dialect door (/v1/messages). Accepts the Anthropic request shape and answers message objects or Anthropic SSE frames; error bodies use the Anthropic error envelope. x-api-key or bearer both authenticate.

• Operation id: postV1Messages
• Scope: chat
• Exposure: public
• Mutating: no
• Auth: bearerAuth, apiKeyAuth

Request

• Request body (application/json, required): AnthropicRequest: AnthropicRequest (object)

Field	Type	Required	Notes
max_tokens	integer	yes
messages	array of object	yes
model	string	yes
stream	boolean	no
system		no	string or content-block array
temperature	number	no
tools	array of object	no

Responses

• 200: Completion, or an SSE stream when the request sets stream:true
  • Streaming: text/event-stream
  • application/json: AnthropicMessage: AnthropicMessage (object)
• 400: schema_invalid
  • application/json: AnthropicError: AnthropicError (object)
• 401: bad_credentials
  • application/json: AnthropicError: AnthropicError (object)
• 402: quota_exhausted (cool-down applied)
  • application/json: AnthropicError: AnthropicError (object)
• 403: auth_scope
  • application/json: AnthropicError: AnthropicError (object)
• 413: payload_too_large
  • application/json: AnthropicError: AnthropicError (object)
• 429: rate_limited (RPM or concurrency)
  • application/json: AnthropicError: AnthropicError (object)
• 502: upstream_error — every attempted seat failed
  • application/json: AnthropicError: AnthropicError (object)
• 503: model_no_eligible_seat
  • application/json: AnthropicError: AnthropicError (object)