---
title: "API endpoint reference — Context Infrastructure"
canonical: "https://press.getalchemystai.com/books/context-infrastructure-build-ai-that-understands-your-business/appendix-a-api-endpoint-reference"
last_updated: "2018-10-20"
book: "Context Infrastructure"
label: "Appendix A"
---

# API endpoint reference

Base URL `https://platform-backend.getalchemystai.com` (override with `ALCHEMYST_AI_BASE_URL`). Authenticate with a bearer token: your API key from the platform's **Get Started** page. SDK calls are from `@alchemystai/sdk` 0.11.1; the Python SDK mirrors them in snake_case.

| Method | Path | Purpose | TypeScript SDK |
| --- | --- | --- | --- |
| POST | `/api/v1/context/add` | Add context documents | `client.v1.context.add()` |
| POST | `/api/v1/context/add-async` | Queue context for background processing | `client.v1.context.addAsync.create()` |
| GET | `/api/v1/context/add-async/status` | List your ingestion jobs | `client.v1.context.addAsync.status.list()` |
| GET | `/api/v1/context/add-async/{id}/status` | Status and result of one job | `client.v1.context.addAsync.status.retrieve(id)` |
| DELETE | `/api/v1/context/add-async/{id}/cancel` | Cancel a waiting or delayed job | `client.v1.context.addAsync.cancel(id)` |
| POST | `/api/v1/context/search` | Search context | `client.v1.context.search()` |
| POST | `/api/v1/context/search/steer` | Search and return a grounded answer | REST call (Chapter 10) |
| POST | `/api/v1/context/delete` | Delete context by source, document or id | `client.v1.context.delete()` |
| POST | `/api/v1/context/memory/add` | Add session memory | `client.v1.context.memory.add()` |
| POST | `/api/v1/context/memory/update` | Update session memory | `client.v1.context.memory.update()` |
| POST | `/api/v1/context/memory/delete` | Delete a memory | `client.v1.context.memory.delete()` |
| GET | `/api/v1/context/view` | View your context (optionally by file or magic key) | `client.v1.context.view.retrieve()` |
| GET | `/api/v1/context/view/docs` | View context by document | `client.v1.context.view.docs()` |
| GET | `/api/v1/context/traces` | List traces, paginated | `client.v1.context.traces.list()` |
| DELETE | `/api/v1/context/traces/{traceId}/delete` | Delete a trace | `client.v1.context.traces.delete(id)` |
| POST | `/api/v1/org/context/view` | View organisation-level context | See API reference |

**MCP tools** at `https://mcp.getalchemystai.com/mcp` (OAuth 2.1 with PKCE, Streamable HTTP): `alchemyst_ai_memory_add`, `alchemyst_ai_memory_update`, `alchemyst_ai_memory_delete`, `alchemyst_ai_memory_search` and `alchemyst_ai_delete_context`, alongside the context search tools.

---

- Previous: [Glossary: Glossary](https://press.getalchemystai.com/books/context-infrastructure-build-ai-that-understands-your-business/glossary.md)
- Contents: [Context Infrastructure](https://press.getalchemystai.com/books/context-infrastructure-build-ai-that-understands-your-business.md)
- Next: [Appendix B: Platform limits and error codes](https://press.getalchemystai.com/books/context-infrastructure-build-ai-that-understands-your-business/appendix-b-platform-limits-and-error-codes.md)
