Source: <https://everruns.com/docs/api/groups/knowledge-memory/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Agent API](https://everruns.com/docs/api/groups/agent-api/)

Agent API

# Call your agent.

Preview

Call one agent: start sessions, send messages, stream results and respond to questions or tool approvals.

Agent-scoped credentialsLive event streamingPython · TypeScript · Rust

[Start a session →](https://everruns.com/docs/api/operations/agent_api_create_session/)[Authentication & usage guide ↗](https://everruns.com/docs/features/agent-api/)

[01](https://everruns.com/docs/api/operations/agent_api_create_session/)

## [Start a session](https://everruns.com/docs/api/operations/agent_api_create_session/)

[Create a conversation on one agent.](https://everruns.com/docs/api/operations/agent_api_create_session/)

[02](https://everruns.com/docs/api/operations/agent_api_send_message/)

## [Send a message](https://everruns.com/docs/api/operations/agent_api_send_message/)

[Start a turn or steer one in progress.](https://everruns.com/docs/api/operations/agent_api_send_message/)

[03](https://everruns.com/docs/api/operations/agent_api_stream_events/)

## [Follow events](https://everruns.com/docs/api/operations/agent_api_stream_events/)

[Stream results, questions and approvals.](https://everruns.com/docs/api/operations/agent_api_stream_events/)

## Endpoints

Support All levels (all)

### Agent API

[GET**Get agent card**`/v1/channels/{channel_id}`Preview](https://everruns.com/docs/api/operations/agent_api_get_card/)[GET**Get work chat config**`/v1/channels/{channel_id}/chat/config`Preview](https://everruns.com/docs/api/operations/get_work_chat_config/)[POST**Resolve work chat main**`/v1/channels/{channel_id}/chat/main`Preview](https://everruns.com/docs/api/operations/resolve_work_chat_main/)[GET**Read work chat share**`/v1/channels/{channel_id}/chat/shared/{token}`Preview](https://everruns.com/docs/api/operations/read_work_chat_share/)[GET**Get work chat view**`/v1/channels/{channel_id}/chat/view`Preview](https://everruns.com/docs/api/operations/get_work_chat_view/)[PUT**Set work chat view preference**`/v1/channels/{channel_id}/chat/view`Preview](https://everruns.com/docs/api/operations/set_work_chat_view_preference/)[POST**Create a runtime token**`/v1/channels/{channel_id}/runtime-auth`Preview](https://everruns.com/docs/api/operations/exchange/)[GET**List sessions**`/v1/channels/{channel_id}/sessions`Preview](https://everruns.com/docs/api/operations/agent_api_list_sessions/)[POST**Start a session**`/v1/channels/{channel_id}/sessions`Preview](https://everruns.com/docs/api/operations/agent_api_create_session/)[GET**Get a session**`/v1/channels/{channel_id}/sessions/{session_id}`Preview](https://everruns.com/docs/api/operations/agent_api_get_session/)[POST**Cancel a turn**`/v1/channels/{channel_id}/sessions/{session_id}/cancel`Preview](https://everruns.com/docs/api/operations/agent_api_cancel/)[GET**Read events**`/v1/channels/{channel_id}/sessions/{session_id}/events`Preview](https://everruns.com/docs/api/operations/agent_api_list_events/)[GET**Get work chat files**`/v1/channels/{channel_id}/sessions/{session_id}/files`Preview](https://everruns.com/docs/api/operations/get_work_chat_files/)[POST**Write work chat file**`/v1/channels/{channel_id}/sessions/{session_id}/files`Preview](https://everruns.com/docs/api/operations/write_work_chat_file/)[DELETE**Delete work chat file**`/v1/channels/{channel_id}/sessions/{session_id}/files`Preview](https://everruns.com/docs/api/operations/delete_work_chat_file/)[POST**Send a message**`/v1/channels/{channel_id}/sessions/{session_id}/messages`Preview](https://everruns.com/docs/api/operations/agent_api_send_message/)[PUT**Add a reaction**`/v1/channels/{channel_id}/sessions/{session_id}/messages/{message_id}/reactions/{emoji}`Preview](https://everruns.com/docs/api/operations/agent_api_add_reaction/)[DELETE**Remove a reaction**`/v1/channels/{channel_id}/sessions/{session_id}/messages/{message_id}/reactions/{emoji}`Preview](https://everruns.com/docs/api/operations/agent_api_remove_reaction/)[POST**Answer questions**`/v1/channels/{channel_id}/sessions/{session_id}/question-answers`Preview](https://everruns.com/docs/api/operations/agent_api_answer_questions/)[GET**List reactions**`/v1/channels/{channel_id}/sessions/{session_id}/reactions`Preview](https://everruns.com/docs/api/operations/agent_api_list_reactions/)[POST**Update work chat conversation**`/v1/channels/{channel_id}/sessions/{session_id}/settings`Preview](https://everruns.com/docs/api/operations/update_work_chat_conversation/)[POST**Share work chat conversation**`/v1/channels/{channel_id}/sessions/{session_id}/share`Preview](https://everruns.com/docs/api/operations/share_work_chat_conversation/)[DELETE**Revoke work chat share**`/v1/channels/{channel_id}/sessions/{session_id}/share`Preview](https://everruns.com/docs/api/operations/revoke_work_chat_share/)[GET**Stream events**`/v1/channels/{channel_id}/sessions/{session_id}/sse`Preview](https://everruns.com/docs/api/operations/agent_api_stream_events/)[POST**Approve tool calls**`/v1/channels/{channel_id}/sessions/{session_id}/tool-approvals`Preview](https://everruns.com/docs/api/operations/agent_api_submit_tool_approvals/)[GET**List work chat tasks**`/v1/channels/{channel_id}/sessions/{session_id}/work`Preview](https://everruns.com/docs/api/operations/list_work_chat_tasks/)[GET**Get work chat by host**`/v1/work-chat/hosts/{label}`Preview](https://everruns.com/docs/api/operations/get_work_chat_by_host/)

No matching endpoints.

cURLTypeScriptPython

Request

```bash
curl --request POST \
  "$EVERRUNS_AGENT_URL/sessions" \
  --header "Authorization: Bearer $EVERRUNS_AGENT_KEY" \
  --header "Content-Type: application/json" \
  --data '{"title": "Order 42"}'
```

Request

```typescript
import { AgentClient } from "@everruns/sdk";


const agent = new AgentClient();
const session = await agent.createSession({
  title: "Order 42",
  idempotencyKey: "order-42-start",
});
```

Request

```python
from everruns_sdk import AgentClient


async with AgentClient() as agent:
    session = await agent.create_session(
        "Order 42",
        idempotency_key="order-42-start",
    )
```

Additional language examples require JavaScript. The default request example is available above.

201400401403404429

201 · Session started

```json
{
  "archived": true,
  "created_at": "2026-10-12T09:00:00Z",
  "id": "session_01933b5a000070008000000000000001",
  "pinned": true,
  "status": "idle",
  "updated_at": "2026-10-12T09:00:00Z"
}
```

400 · Invalid body, or the retired api_endpoint body \`{"message": …}\`

```json
{
  "title": "Invalid body, or the retired api_endpoint body `{\"message\": …}`",
  "status": 400
}
```

401 · Missing or invalid credentials

```json
{
  "title": "Missing or invalid credentials",
  "status": 401
}
```

403 · Agent not available

```json
{
  "title": "Agent not available",
  "status": 403
}
```

404 · Channel not found

```json
{
  "title": "Channel not found",
  "status": 404
}
```

429 · Rate or daily spending limit reached

```json
{
  "title": "Rate or daily spending limit reached",
  "status": 429
}
```

[Migrating from /v1/e/? View deprecated routes →](https://everruns.com/docs/api/groups/deprecated/)

## Matching endpoints

## Support & compatibility

* Stable

  Documented compatibility. Breaking changes follow an announced deprecation period.

* Preview

  Public early access. Breaking changes may occur; review the changelog before upgrading.

* Experimental

  Evaluation only. No compatibility guarantee; the endpoint lists its availability requirements.

* Internal

  Platform operation and diagnostics. No external compatibility commitment.

* Deprecated

  Use the linked replacement or migration guide. Removal dates appear only when announced.

Current public APIs are Preview unless marked Experimental. Support labels describe compatibility, not access permissions or a service-level agreement.

## Agent credentials

Agent key (evr_ak\_…), channel runtime token, or a token accepted by the channel’s configured identity provider. Personal access tokens require org_members. Runtime-auth accepts an agent key with End-User or a configured identity-provider token; runtime tokens cannot renew themselves.

[Authentication and end-user guide →](https://everruns.com/docs/features/agent-api/#authentication)