Anthropic

Anthropic Events API

User messages and tool results sent to a session

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/sessions/{session_id}/events Send user messages or interrupts to a session · Anthropic Send Session Events #
Ask an LLM
“How do I send a user message or tool result to a running agent session?”
“Can I interrupt an agent session that's in the middle of working?”
Tell an agent
Send events {events} to session {session_id}.
Interrupt session {session_id} with events {events}.
GET /v1/sessions/{session_id}/stream Stream a session's agent activity · Anthropic Stream Session Events #
Ask an LLM
“How can I watch an agent's messages and tool calls live as a session runs?”
“Does the session stream include status changes as well as assistant output?”
Tell an agent
Stream the activity of session {session_id}.
Follow tool calls and replies from session {session_id} as server-sent events.

Documentation

📖
Documentation
https://docs.anthropic.com/en/api/admin-api/users/get-user
📖
Documentation
https://docs.anthropic.com/en/api/prompt-tools-generate
📖
Documentation
https://docs.anthropic.com/en/api/usage-cost-api
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/overview
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/agent-setup
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/sessions
📖
Documentation
https://platform.claude.com/docs/en/managed-agents/environments

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/anthropic/refs/heads/main/openapi/anthropic-events-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/anthropic-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

anthropic-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Anthropic Managed Agents Events API
  description: Claude Managed Agents is a fully managed agent harness for running Claude as an autonomous agent with secure sandboxing, built-in tools, and server-sent event streaming. Define reusable, versioned Agents, configure Environments (cloud containers or self-hosted sandboxes), and run stateful Sessions that perform long-running tasks. All endpoints require the managed-agents-2026-04-01 beta header.
  version: 2026-04-01
  contact:
    name: Anthropic Support
    url: https://support.claude.com
  license:
    name: Anthropic Terms of Service
    url: https://www.anthropic.com/terms
servers:
- url: https://api.anthropic.com
  description: Production Server
security:
- ApiKeyAuth: []
tags:
- name: Events
  description: User messages and tool results sent to a session
paths:
  /v1/sessions/{session_id}/events:
    post:
      summary: Anthropic Send Session Events
      description: Send user events to drive session execution. Event types include user.message, tool.result, and interrupt.
      operationId: sendSessionEvents
      tags:
      - Events
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/AnthropicBeta'
      - $ref: '#/components/parameters/SessionIdPath'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventBatch'
      responses:
        '200':
          description: Events accepted.
  /v1/sessions/{session_id}/stream:
    get:
      summary: Anthropic Stream Session Events
      description: 'Server-sent events stream of agent execution: assistant messages, tool calls, tool results, and status changes.'
      operationId: streamSession
      tags:
      - Events
      parameters:
      - $ref: '#/components/parameters/AnthropicVersion'
      - $ref: '#/components/parameters/AnthropicBeta'
      - $ref: '#/components/parameters/SessionIdPath'
      responses:
        '200':
          description: SSE stream of session events.
          content:
            text/event-stream:
              schema:
                type: string
components:
  parameters:
    AnthropicVersion:
      name: anthropic-version
      in: header
      required: true
      schema:
        type: string
        default: '2023-06-01'
    AnthropicBeta:
      name: anthropic-beta
      in: header
      required: true
      description: Must include managed-agents-2026-04-01.
      schema:
        type: string
        default: managed-agents-2026-04-01
    SessionIdPath:
      name: session_id
      in: path
      required: true
      schema:
        type: string
  schemas:
    EventBatch:
      type: object
      required:
      - events
      properties:
        events:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                - user.message
                - tool.result
                - interrupt
              content:
                type: array
                items:
                  type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key