# Create a setup for your bot

`POST https://app.skylit.ai/api/nexus/v1/playbooks`

API: Nexus.

Makes a setup on your bot's account, with its checklist in order. Names are unique per account, ignoring case: your bot's "Gap Fill" is not your own "Gap Fill". Up to 50 rules; a name up to 80 characters, a rule up to 200.

```bash
curl -s -X POST "https://app.skylit.ai/api/nexus/v1/playbooks" \
  -H "Authorization: Bearer $SKYLIT_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"VWAP reclaim","color":"#4ade80","rules":["Closes back above VWAP","Risk under 1R"]}'
```

## Authentication

Send your Skylit API key as a bearer token: `Authorization: Bearer <key>`. No other header is accepted.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `account` | query | string | no | `agent` (your bot's setups, the default on these routes) or `main` (your own, read only by key). (one of `agent`, `main`; default `agent`) |

## Request body

`application/json`

```json
{
  "name": "string",
  "description": "string",
  "color": "#4ade80",
  "rules": [
    "string"
  ]
}
```

## Example request

```bash
curl "https://app.skylit.ai/api/nexus/v1/playbooks" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"
```

## Responses

### 201

The new setup.

The setup that was made.:

```json
{
  "data": {
    "playbook": {
      "id": "0abda435-bf55-44ec-b837-6647a07d3f25",
      "userId": "f6ed04ec-427c-4354-a83d-1f5669cfd81b",
      "name": "VWAP reclaim",
      "color": "#4ade80",
      "book": "agent",
      "createdAt": "2026-11-18T13:57:56.998793-05:00",
      "updatedAt": "2026-11-18T13:57:56.998793-05:00",
      "rules": [
        {
          "id": "ca203ef2-9463-4083-a2e7-f3114717607a",
          "playbookId": "0abda435-bf55-44ec-b837-6647a07d3f25",
          "label": "Closes back above VWAP",
          "position": 0,
          "createdAt": "2026-11-18T13:57:56.998793-05:00",
          "updatedAt": "2026-11-18T13:57:56.998793-05:00"
        },
        {
          "id": "0607f5c7-b14c-4eaf-b481-8186ae6789ab",
          "playbookId": "0abda435-bf55-44ec-b837-6647a07d3f25",
          "label": "Risk under 1R",
          "position": 1,
          "createdAt": "2026-11-18T13:57:56.998793-05:00",
          "updatedAt": "2026-11-18T13:57:56.998793-05:00"
        }
      ]
    }
  },
  "meta": {
    "account": "agent"
  }
}
```

### 400

`bad_request`: a blank or too long name or rule, too many rules, an unknown field.

### 403

`main_account_web_only`: your own account's setups and tags are changed only on skylit.ai, signed in as yourself.

### 409

`name_taken`: your bot already has a live setup with that name. `setup_limit`: it has 100 live setups, the most an account holds; archive one first.
