Quickstart

Get up and running with the Tess AI API in a few minutes.

Create an API Key

To use the Tess AI API, you’ll need an API key. You can create one by:

Going directly to #Tess AI → User Tokens
Or navigating through the UI:
- Visit #Tess AI
- Click on the User Menu
- Select “API Tokens”
- Click “Add New Token”

Set up your API Key (recommended)

Configure your API key as an environment variable. This approach streamlines your API usage by eliminating the need to include your API key in each request. Moreover, it enhances security by minimizing the risk of inadvertently including your API key in your codebase.

Required headers

Every authenticated API call needs:

Authorization: Bearer YOUR_API_KEY
x-workspace-id: YOUR_WORKSPACE_ID

x-workspace-id is required as of 2026-09-01. Until then, omitting it falls back to your selected workspace (deprecated). After the cutoff, missing header → 422. See API Overview and Errors. Example:

curl --request GET \
  --url 'https://api.tess.im/agents' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'x-workspace-id: YOUR_WORKSPACE_ID'

Next Steps

Now that you’ve made your first API call, you can explore:

API Guide

API Reference

Integrations

Model Context Protocol (MCP)

Create an API Key

Set up your API Key (recommended)

Required headers

Next Steps

​Create an API Key

​Set up your API Key (recommended)

​Required headers

​Next Steps

Create an API Key

Set up your API Key (recommended)

Required headers

Next Steps