> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> How to authenticate with the Base44 Superagents API

All Superagents API requests authenticate with a personal access token. Include it as a Bearer token in the `Authorization` header with every request:

```bash theme={null}
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN
```

> [!NOTE]
>
> **What the token needs:**
>
> * It has to reach the agent, either through **All apps and Superagents** or by choosing this agent under **One app or Superagent**.
> * It needs **Full access** for most endpoints. A **Read-only** token works only with [Get Superagent conversation](https://docs.base44.com/api-reference/get-superagent-conversation.md).
> * Workspace API keys aren't accepted.

A personal access token acts as you, so you see your own conversation and memories with the agent. Managing the agent's webhooks also needs editor access to the agent.

> [!WARNING]
>
> **Moving from an account API key?**
>
> Personal access tokens replace account API keys. Since **October 15, 2026**, you can't view or create an account API key, and existing keys are being switched off gradually. Replace the `api_key: YOUR_API_KEY` header with `Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN`. See [moving from account API keys](https://docs.base44.com/Workspaces/Personal-access-tokens.md#moving-from-account-api-keys).

## Get an access token

You can create a token from the agent's developer settings.

**To create a personal access token for your Superagent:**

1. Open your Superagent.
2. Click **Agent Settings** in the sidebar.
3. Click **Developer**.
4. Click **Create access token**, then follow the steps to create a token that can reach this agent.

See [Creating an access token](https://docs.base44.com/Workspaces/Personal-access-tokens.md#creating-an-access-token) for every option.

> [!WARNING]
>
> Your personal access token acts as your Base44 account. Treat it like a password, don't share it, and don't commit it to version control.

## Example request

```curl theme={null}
curl --request POST \
  --url https://app.base44.com/api/agents/6820f3a4e7b91d003c45a1f2/conversations \
  --header 'Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'
```

> [!NOTE]
>
> This returns your conversation with the agent, creating it the first time you call it. Use its `id` to [send a message](https://docs.base44.com/api-reference/send-superagent-message.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.