# agents.composio.dev

> start using composio without needing your human to sign up.

## signup

agents sign themselves up. no human required. we mint a slug, issue an `agent_key`, and complete the magic-link signup against composio on your behalf.

```http
POST /api/signup
Content-Type: application/json
```

**Request**

```json
{}
```

**Response**

```json
{
  "status": "ready",
  "slug": "amber-cedar-otter",
  "email": "amber-cedar-otter@agents.meowmeowmeow.ai",
  "agent_key": "composio_agent_key_xxx",
  "composio": {
    "member_id": "uuid",
    "org_id": "org_xxx",
    "project_id": "proj_xxx",
    "api_key": "ak_xxx",
    "user_api_key": "uak_xxx"
  }
}
```

## whoami

authenticated with your `agent_key`. returns your project api key. does not return the org access token.

```http
GET /api/whoami
Authorization: Bearer composio_agent_key_...
```

**Response**

```json
{
  "slug": "amber-cedar-otter",
  "email": "amber-cedar-otter@agents.meowmeowmeow.ai",
  "status": "READY",
  "claimed_by": null,
  "claimed_at": null,
  "composio": {
    "member_id": "uuid",
    "org_id": "org_xxx",
    "project_id": "proj_xxx",
    "api_key": "ak_xxx",
    "user_api_key": "uak_xxx"
  }
}
```

## cli

get a ready-to-paste install + login prompt with your user api key and org id already filled in. pass it to whatever coding agent you're using and it'll set up the composio cli for you.

```http
GET /api/cli
Authorization: Bearer composio_agent_key_...
```

**Response**

```
Install Composio CLI using this command. It automatically adds the OpenClaw skill for you:

curl -fsSL https://composio.dev/install | bash

Then log in using this command:

composio login --user-api-key "uak_..." --org "ok_..."
```

## claim

hand control to a human. pass a human email; we email them an invite to join your composio org as an admin.

```http
POST /api/claim
Authorization: Bearer composio_agent_key_...
Content-Type: application/json
```

**Request**

```json
{
  "email": "human@example.com"
}
```

**Response**

```json
{
  "status": "invited",
  "email": "human@example.com",
  "org_id": "org_xxx",
  "invite_code": "inv_xxx"
}
```

## inbox

each agent has an inbox at `slug@agents.meowmeowmeow.ai`. read the most recent messages:

```http
GET /api/mail?limit=50
Authorization: Bearer composio_agent_key_...
```

**Response**

```json
{
  "count": 1,
  "emails": [
    {
      "id": "cuid",
      "from": "no-reply@composio.dev",
      "to": "amber-cedar-otter@agents.meowmeowmeow.ai",
      "subject": "Sign in to Composio",
      "text": "...",
      "html": "...",
      "processed": true,
      "process_note": "magic link verified; agent READY",
      "received_at": "2026-04-13T22:00:00.000Z"
    }
  ]
}
```

## agent keys

- prefixed `composio_agent_key_`

- only valid against this surface: `/whoami`, `/mail`, `/claim`, `/cli`

- not a composio api key — the real api key is returned by `/whoami`

## agent email domain

each agent is assigned `three-word-slug@agents.meowmeowmeow.ai`.

---

your agent decides what to do, composio handles the rest — just-in-time tool calls, secure delegated auth, sandboxed environments, and parallel execution across 1,000+ apps. [docs.composio.dev](https://docs.composio.dev)