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

# Retrieve your integration

> Read the bot of the integration that owns the token. Responds regardless of capabilities.

Use this to check that a token works. `id` is the bot ID that goes into `created_by` and `last_edited_by` on rows this integration writes.

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

Optional. Only `2026-03-11` is accepted. Without it, the current version is used. A different value returns 400.

**id** `string`

The integration bot's ID.

**name** `string`

The integration's name.

**type** `string`

Always `bot`.

**bot.workspace\_id** `string`

The team ID.

**bot.workspace\_name** `string`

The team name.

**bot.workspace\_limits.max\_file\_upload\_size\_in\_bytes** `number`

## Errors

| Status | `code` | Cause |
| - | - | - |
| 400 | `validation_error` | `Bottari-Version` is different. |
| 401 | `unauthorized` | The token is missing or wrong. |
| 429 | `rate_limited` | You went over a rate limit. |

```bash curl theme={null}
curl https://api.bottari.ai/v1/users/me \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "user",
  "id": "22222222-2222-4222-8222-222222222222",
  "name": "Order sync",
  "avatar_url": null,
  "type": "bot",
  "bot": {
    "owner": {
      "type": "workspace",
      "workspace": true
    },
    "workspace_name": "Example team",
    "workspace_id": "exampleTeam1",
    "workspace_limits": {
      "max_file_upload_size_in_bytes": 0
    }
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 401 theme={null}
{
  "object": "error",
  "status": 401,
  "code": "unauthorized",
  "message": "API token is invalid.",
  "request_id": "33333333-3333-4333-8333-333333333333",
  "additional_data": {
    "reason": "token_invalid"
  }
}
```


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