API Evangelist conversational phrasing for Anthropic Messages API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Anthropic Messages API
  version: 1.0.0
extends: openapi/anthropic-messages-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 16
- target: $.paths['/v1/messages'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate Claude's next message in a conversation
      effect: write
      questions:
      - How do I send a prompt to Claude and get a reply back?
      - Can I stream the response and set a system prompt, temperature and max tokens?
      - Which parameters let me give Claude tools and control how it picks one?
      instructions:
      - text: Ask model {model} to reply to {messages} in at most {max_tokens} tokens.
        slots:
          model: requestBody.model
          messages: requestBody.messages
          max_tokens: requestBody.max_tokens
      - text: Send {messages} to {model} with system prompt {system}, capped at {max_tokens} tokens, and stream the answer.
        slots:
          messages: requestBody.messages
          model: requestBody.model
          system: requestBody.system
          max_tokens: requestBody.max_tokens
      - text: Have {model} answer {messages} using tools {tools}, limited to {max_tokens} output tokens.
        slots:
          model: requestBody.model
          messages: requestBody.messages
          tools: requestBody.tools
          max_tokens: requestBody.max_tokens
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches'].get
  update:
    x-apievangelist-phrasing:
      intent: List message batches in a workspace
      effect: read
      questions:
      - Which message batches have I submitted in this workspace, newest first?
      - Can I page backward or forward through my batch list by ID?
      instructions:
      - text: List my {limit} most recent message batches.
        slots:
          limit: query.limit
      - text: Show the message batches created after batch {after_id}.
        slots:
          after_id: query.after_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a batch of message requests
      effect: write
      questions:
      - How do I run many Claude prompts at once asynchronously?
      - Does a message batch start processing as soon as I submit it?
      instructions:
      - text: Submit message batch requests {requests}.
        slots:
          requests: requestBody.requests
      - text: Queue these prompts {requests} as one asynchronous message batch.
        slots:
          requests: requestBody.requests
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a message batch's processing status
      effect: read
      questions:
      - Is my message batch done processing yet?
      - Where do I find the results URL for a finished batch?
      instructions:
      - text: Check the status of message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: Poll batch {message_batch_id} until it finishes processing.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a finished message batch
      effect: destructive
      questions:
      - Can I delete a message batch that's still processing?
      - How do I clean up an old message batch once it's finished?
      instructions:
      - text: Delete finished message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: Clean up completed batch {message_batch_id} from my workspace.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel an in-progress message batch
      effect: destructive
      questions:
      - How do I stop a message batch before it finishes?
      - What state does a batch go into right after I cancel it?
      instructions:
      - text: Cancel message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: Stop processing the rest of batch {message_batch_id} now.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}/cancel?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a message batch via the beta flag
      effect: destructive
      questions:
      - Can I cancel a running batch through the beta message batches endpoint?
      - Which beta-flag call halts a batch that's still processing?
      instructions:
      - text: Cancel beta message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: With the beta flag, halt in-flight batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}/results'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a message batch's results
      effect: read
      questions:
      - How do I get the responses back from a completed message batch?
      - Are batch results returned in the same order as my requests?
      instructions:
      - text: Download the results of batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: Stream the .jsonl results file for message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}/results?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Download batch results via the beta flag
      effect: read
      questions:
      - Can I pull a batch's .jsonl results through the beta endpoint?
      - What's the beta-flag way to read every result line of a batch?
      instructions:
      - text: Get beta results for message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: With the beta flag, fetch the result lines for batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a batch's status via the beta flag
      effect: read
      questions:
      - How do I poll a batch's progress through the beta message batches endpoint?
      - Does the beta batch lookup return the results URL too?
      instructions:
      - text: Get beta message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: With the beta flag, check whether batch {message_batch_id} has ended.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches/{message_batch_id}?beta=true'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a message batch via the beta flag
      effect: destructive
      questions:
      - Can I delete a completed batch through the beta endpoint?
      - What's the beta-flag call to remove an old message batch?
      instructions:
      - text: Delete beta message batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      - text: With the beta flag, remove ended batch {message_batch_id}.
        slots:
          message_batch_id: path.message_batch_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches?beta=true'].get
  update:
    x-apievangelist-phrasing:
      intent: List message batches via the beta flag
      effect: read
      questions:
      - Which batches does the beta message batches listing show for my workspace?
      - Can I page the beta batch list using a before ID?
      instructions:
      - text: List beta message batches, {limit} per page.
        slots:
          limit: query.limit
      - text: With the beta flag, show batches created before {before_id}.
        slots:
          before_id: query.before_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/batches?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a message batch via the beta flag
      effect: write
      questions:
      - Can I create a message batch with beta features using the beta endpoint?
      - Which beta-flag call queues many message requests in one go?
      instructions:
      - text: Create a beta message batch from {requests}.
        slots:
          requests: requestBody.requests
      - text: With the beta flag, send {requests} for asynchronous processing.
        slots:
          requests: requestBody.requests
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/count_tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Count the tokens in a message before sending
      effect: read
      questions:
      - How many tokens will my prompt use before I actually send it to Claude?
      - Does the token count include tools, images and documents?
      instructions:
      - text: Count the tokens {messages} would use on {model}.
        slots:
          messages: requestBody.messages
          model: requestBody.model
      - text: Estimate input tokens for {messages} with system prompt {system} and tools {tools} on {model}.
        slots:
          messages: requestBody.messages
          system: requestBody.system
          tools: requestBody.tools
          model: requestBody.model
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages/count_tokens?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Count message tokens including MCP servers (beta)
      effect: read
      questions:
      - Can I count tokens for a prompt that uses MCP servers or context management?
      - What's the beta-flag token counter for requests with an output format?
      instructions:
      - text: With the beta flag, count tokens for {messages} on {model} including MCP servers {mcp_servers}.
        slots:
          messages: requestBody.messages
          model: requestBody.model
          mcp_servers: requestBody.mcp_servers
      - text: Tally beta token usage for {messages} on {model} with context management {context_management}.
        slots:
          messages: requestBody.messages
          model: requestBody.model
          context_management: requestBody.context_management
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/messages?beta=true'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a message with beta features
      effect: write
      questions:
      - How do I call Claude with MCP servers connected directly in the request?
      - Can I set fallback models or an output format on a message using the beta endpoint?
      - Where do I turn on context management or a faster speed for a single message?
      instructions:
      - text: With the beta flag, have {model} reply to {messages} in up to {max_tokens} tokens using MCP servers {mcp_servers}.
        slots:
          model: requestBody.model
          messages: requestBody.messages
          max_tokens: requestBody.max_tokens
          mcp_servers: requestBody.mcp_servers
      - text: Send beta message {messages} to {model}, max {max_tokens} tokens, falling back to {fallbacks}.
        slots:
          messages: requestBody.messages
          model: requestBody.model
          max_tokens: requestBody.max_tokens
          fallbacks: requestBody.fallbacks
      - text: Get a {output_format} formatted reply from {model} to {messages} within {max_tokens} tokens via the beta endpoint.
        slots:
          output_format: requestBody.output_format
          model: requestBody.model
          messages: requestBody.messages
          max_tokens: requestBody.max_tokens
      method: generated
      generated: '2026-09-26'