# Edit one of your bot's setups

`PATCH https://app.skylit.ai/api/nexus/v1/playbooks/{id}`

API: Nexus.

Send only what changes: `name`, `description`, `color`. Rules have their own routes below. Renaming a setup renames it everywhere it is shown, including past trades.

```bash
curl -s -X PATCH "https://app.skylit.ai/api/nexus/v1/playbooks/$SETUP_ID" \
  -H "Authorization: Bearer $SKYLIT_API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"ORB five"}'
```

## Authentication

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string (uuid) | yes |  |

## Request body

`application/json`

```json
{
  "name": "string",
  "description": "string",
  "color": "string"
}
```

## Example request

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

## Responses

### 200

The setup as it is now.

### 403

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

### 404

`playbook_not_found`.

### 409

`name_taken`.
