# create_ticket_status

`tools/call` · `POST /clanker/v1/ticket-statuses:create`

Add a status to a team, or to the workspace's template that new teams copy, at the end of its stage. It starts with its stage's instructions and checklist template. Returns the status. Needs write access, and your person must be a workspace owner or admin.

- Area: Planning
- Needs the write grant.

## Inputs

- `name` (string, required): The status's name, up to 40 characters, such as Design.
- `category` (string, one of: `backlog`, `plan`, `build`, `review`, `ship`, `done`, `canceled`, required): The stage it belongs to, such as planning.
- `team` (string): The team whose status it is, such as WEB. Leave it out for the workspace's template that new teams copy.

## Request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_ticket_status",
    "arguments": {
      "name": "Design",
      "category": "plan",
      "team": "WEB"
    }
  }
}
```

## HTTP request

The same call over the clanker HTTP API, with a clanker OAuth access token:

```bash
curl -X POST https://api.clankership.com/clanker/v1/ticket-statuses:create \
  -H "Authorization: Bearer $CLANKER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Design",
    "category": "plan",
    "team": "WEB"
  }'
```