Skip to main content
Welcome to the Tess AI API documentation! This guide will help you get started with our API and understand how to integrate Tess AI’s powerful capabilities into your applications.

​
Base URL

All API requests should be made to the following base URL:

​
Authentication

All API requests require authentication using an API key. You can obtain your API key from the Tess AI Dashboard. To authenticate your requests, include your API key in the Authorization header:

​
Workspace header

Authenticated API requests must include the workspace context header:
Required as of 2026-09-01 for agent execution and other authenticated API endpoints. Until then, if omitted, the API falls back to the user’s selected workspace (deprecated). After the cutoff, a missing header returns 422. See Errors.

​
API Endpoints

The Tess AI API provides the following main categories of endpoints:

​
Agents

​
Agent Files

​
Agent Webhooks

​
Workspaces

​
Audit Events

​
Memories

​
Memory Collections

​
Files

​
Webhooks

​
Request Format

Most API endpoints accept JSON-encoded request bodies. Make sure to include the following header in your requests:

​
Response Format

All API responses are returned in JSON format. A successful response will typically have a 2xx HTTP status code and contain the requested data. Error responses will have a 4xx or 5xx status code and include an error message.