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

# API overview

> Use the ImpelLabs API to read and change your workspace from your own systems.

The ImpelLabs API gives your own code the same access that a member has in the app. You can list conversations, add contacts, change agents, start workflows and read credits. Use it for your own scripts and for your own systems.

## Base URL

All routes are under one address and one prefix:

```text theme={null}
https://api.impellabs.tech/api/v1/
```

Send and read JSON. Set `Content-Type: application/json` on a request with a body.

## A first request

Make an API token in the app, then call a route. This request returns the member that owns the token:

```bash theme={null}
curl https://api.impellabs.tech/api/v1/me \
  -H "Authorization: Bearer imp_..."
```

Read [Authentication](https://docs.impellabs.tech/api/authentication.md) to make a token.

## What the token can do

A token acts as the member who made it. It has that member's role. It sees what that member sees. Agents and channels that are private to someone else stay private. An owner or an admin sees oversight data only: name, owner, status, sharing and spend, never content.

The token names its workspace. You do not choose a workspace in a request.

## What is in the reference

The API reference group in the sidebar lists every supported route with its fields. Guides for each resource explain how the routes work together. The reference does not list the app's own routes, such as sign-in and account routes. Those routes need a signed-in session in the app.

## Other ways in

* Your own AI client can use the same access through the [MCP server](https://docs.impellabs.tech/connect/overview.md).
* ImpelLabs can call you. See [Webhooks](https://docs.impellabs.tech/api/webhooks.md).
* Partners who run ImpelLabs for their own customers use the [Partner API](https://docs.impellabs.tech/partners/overview.md).

Next, read [Conventions](https://docs.impellabs.tech/api/conventions.md) for errors, paging and time.


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