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

# Apps

> Register and read the apps Stratos AI generates content for.

An "app" maps directly onto the same `products` record the Stratos AI dashboard uses — create one via the API and it shows up in the dashboard immediately, and vice versa.

## Create an app

Requires `apps:write`. **Free** — no credits spent.

```bash theme={null}
curl -X POST https://www.try-orbit.com/api/v1/apps \
  -H "Authorization: Bearer $STRATOS_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Macrosnap", "appStoreUrl": "https://apps.apple.com/us/app/macrosnap/id123"}'
```

```json 201 theme={null}
{
  "data": {
    "id": "product_a1b2c3d4e5f6",
    "name": "Macrosnap",
    "details": "Track your macros in one photo...",
    "createdAt": "2026-08-15T12:00:00.000Z",
    "updatedAt": "2026-08-15T12:00:00.000Z",
    "seedHooks": ["5 macro tracking mistakes...", "..."]
  }
}
```

## List apps

`GET /v1/apps` — requires `apps:read`.

## Get an app

`GET /v1/apps/{id}` — requires `apps:read`. `404 not_found` if the app doesn't exist or isn't owned by this key's account.