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

# API reference

> Every route, with a playground to try it.

```text theme={"system"}
https://api.constella.app/platform/v1
```

## Two ways in

> [card] [Your memory](/dev/docs/api-reference/me/call-tool.md)
>
> `/platform/v1/me/tools/{name}` with your own key (`csk_`).

> [card] [Your app's users](/dev/docs/api-reference/users/call-tool.md)
>
> `/platform/v1/users/{uid}/tools/{name}` with a project key (`cak_live_`).

## The call shape

Every tool is called the same way. Send its arguments under `arguments`. The answer comes back under `result`.

```http theme={"system"}
POST /platform/v1/me/tools/memory_add
Authorization: Bearer $CONSTELLA_API_KEY
Content-Type: application/json

{"arguments": {"text": "We ship on Fridays.", "id": "team:ship-day"}}
```

```json theme={"system"}
{"result": {"id": "team:ship-day", "app": "agents", "updated": false}}
```

Each tool's arguments are on its own page under **Tools**. Errors are always `{"detail": {"code", "message"}}`: see [Errors](/dev/docs/guides/errors.md).

## The OpenAPI file

Load it into Postman, Insomnia or a client generator:

```bash theme={"system"}
curl -O https://www.constella.app/dev/docs/api-reference/openapi.json
```


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