---
title: "Anthropic messages — wildcard (Cursor mount)"
method: POST
path: "/cursor/v1/messages/{path}"
tags: ["Cursor Integration"]
---

# Anthropic messages — wildcard (Cursor mount)

`POST /cursor/v1/messages/{path}`

Cursor mount of the Anthropic messages wildcard (`POST /anthropic/v1/messages/{path}`).
Routes extended Anthropic messages endpoints (e.g. batches, count tokens)
through Cursor.

## Path parameters

- `path` string, required

## Request body

- AnthropicMessageRequest
  - `model` string, required — Model identifier (e.g., claude-3-opus-20240229)
  - `max_tokens` integer, required — Maximum tokens to generate
  - `messages` AnthropicMessage[], required — List of messages in the conversation
    - `role` 'user' | 'assistant', required
    - `content` union, required — Content - can be a string or array of content blocks
      - string
      - AnthropicContentBlock[]
        - `type` 'text' | 'image' | 'document' | 'tool_use' | 'server_tool_use' | 'tool_result' | 'web_search_result' | 'mcp_tool_use' | 'mcp_tool_result' | 'thinking' | 'redacted_thinking', required
        - `text` string — For text content
        - `thinking` string — For thinking content
        - `signature` string — For signature content
        - `data` string — For data content (encrypted data for redacted thinking)
        - `tool_use_id` string — For tool_result content
        - `id` string — For tool_use content
        - `name` string — For tool_use content
        - `input` object — For tool_use content
        - `server_name` string — For mcp_tool_use content
        - `content` union — For tool_result content
          - string
          - AnthropicContentBlock[]
        - `source` object — For image/document content
          - `type` 'base64' | 'url' | 'text' | 'content_block', required
          - `media_type` string — MIME type (e.g., image/jpeg, application/pdf)
          - `data` string — Base64-encoded data (for base64 type)
          - `url` string — URL (for url type)
        - `cache_control` CacheControl — Cache control settings for content blocks
          - `type` 'ephemeral'
          - `ttl` string — Time to live (e.g., "1m", "1h")
        - `citations` object — For document content
          - `enabled` boolean
        - `context` string — For document content
        - `title` string — For document content
  - `system` union — System prompt
    - string
    - AnthropicContentBlock[]
      - `type` 'text' | 'image' | 'document' | 'tool_use' | 'server_tool_use' | 'tool_result' | 'web_search_result' | 'mcp_tool_use' | 'mcp_tool_result' | 'thinking' | 'redacted_thinking', required
      - `text` string — For text content
      - `thinking` string — For thinking content
      - `signature` string — For signature content
      - `data` string — For data content (encrypted data for redacted thinking)
      - `tool_use_id` string — For tool_result content
      - `id` string — For tool_use content
      - `name` string — For tool_use content
      - `input` object — For tool_use content
      - `server_name` string — For mcp_tool_use content
      - `content` union — For tool_result content
        - string
        - AnthropicContentBlock[]
      - `source` object — For image/document content
        - `type` 'base64' | 'url' | 'text' | 'content_block', required
        - `media_type` string — MIME type (e.g., image/jpeg, application/pdf)
        - `data` string — Base64-encoded data (for base64 type)
        - `url` string — URL (for url type)
      - `cache_control` CacheControl — Cache control settings for content blocks
        - `type` 'ephemeral'
        - `ttl` string — Time to live (e.g., "1m", "1h")
      - `citations` object — For document content
        - `enabled` boolean
      - `context` string — For document content
      - `title` string — For document content
  - `cache_control` CacheControl — Cache control settings for content blocks
    - `type` 'ephemeral'
    - `ttl` string — Time to live (e.g., "1m", "1h")
  - `metadata` object
    - `user_id` string
  - `stream` boolean — Whether to stream the response
  - `temperature` number
  - `top_p` number
  - `top_k` integer
  - `stop_sequences` string[]
  - `tools` object[]
    - `type` 'custom' | 'bash_20250124' | 'computer_20250124' | 'computer_20251124' | 'code_execution_20250522' | 'code_execution_20250825' | 'code_execution_20260120' | 'text_editor_20250124' | 'text_editor_20250429' | 'text_editor_20250728' | 'web_search_20250305' | 'web_search_20260209' | 'web_fetch_20250910' | 'web_fetch_20260209' | 'web_fetch_20260309' | 'memory_20250818' | 'tool_search_tool_bm25' | 'tool_search_tool_bm25_20251119' | 'tool_search_tool_regex' | 'tool_search_tool_regex_20251119'
    - `name` string — Tool name (for custom tools)
    - `description` string
    - `input_schema` object — JSON Schema for tool input
    - `cache_control` CacheControl — Cache control settings for content blocks
      - `type` 'ephemeral'
      - `ttl` string — Time to live (e.g., "1m", "1h")
    - `display_width_px` integer
    - `display_height_px` integer
    - `display_number` integer
    - `enable_zoom` boolean
    - `max_uses` integer
    - `allowed_domains` string[]
    - `blocked_domains` string[]
    - `user_location` object
      - `type` 'approximate'
      - `city` string
      - `country` string
      - `timezone` string
  - `tool_choice` object
    - `type` 'auto' | 'any' | 'tool' | 'none'
    - `name` string — Required when type is 'tool'
    - `disable_parallel_tool_use` boolean
  - `mcp_servers` object[] — MCP servers configuration (requires beta header)
    - `type` string
    - `name` string
    - `url` string
    - `authorization_token` string — Authorization token for the MCP server
    - `tool_configuration` object
      - `enabled` boolean
      - `allowed_tools` string[]
  - `thinking` object
    - `type` 'enabled' | 'disabled'
    - `budget_tokens` integer
  - `output_format` object — Structured output format (requires beta header)
  - `fallbacks` string[]

## Response `200`

Successful response

- AnthropicMessageResponse
  - `id` string
  - `type` string
  - `role` string
  - `content` AnthropicContentBlock[]
    - `type` 'text' | 'image' | 'document' | 'tool_use' | 'server_tool_use' | 'tool_result' | 'web_search_result' | 'mcp_tool_use' | 'mcp_tool_result' | 'thinking' | 'redacted_thinking', required
    - `text` string — For text content
    - `thinking` string — For thinking content
    - `signature` string — For signature content
    - `data` string — For data content (encrypted data for redacted thinking)
    - `tool_use_id` string — For tool_result content
    - `id` string — For tool_use content
    - `name` string — For tool_use content
    - `input` object — For tool_use content
    - `server_name` string — For mcp_tool_use content
    - `content` union — For tool_result content
      - string
      - AnthropicContentBlock[]
    - `source` object — For image/document content
      - `type` 'base64' | 'url' | 'text' | 'content_block', required
      - `media_type` string — MIME type (e.g., image/jpeg, application/pdf)
      - `data` string — Base64-encoded data (for base64 type)
      - `url` string — URL (for url type)
    - `cache_control` CacheControl — Cache control settings for content blocks
      - `type` 'ephemeral'
      - `ttl` string — Time to live (e.g., "1m", "1h")
    - `citations` object — For document content
      - `enabled` boolean
    - `context` string — For document content
    - `title` string — For document content
  - `model` string
  - `stop_reason` string
  - `stop_sequence` string, nullable
  - `usage` object
    - `input_tokens` integer
    - `output_tokens` integer
    - `cache_creation_input_tokens` integer
    - `cache_read_input_tokens` integer
    - `cache_creation` object
      - `ephemeral_5m_input_tokens` integer
      - `ephemeral_1h_input_tokens` integer

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/getbifrost/apis/bifrost-api.md) · [All operations](https://skmtc.net/getbifrost/apis/bifrost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbifrost/bifrost-api/versions/f8cab88f64ea/schema)