# create_status (/docs/reference/mcp-tools/create_status)



{/* Generated by apps/docs/scripts/generate-mcp-pages.mjs — do not edit by hand. */}

Add a status to a project (mapped to a fixed category).

|                     |                   |
| ------------------- | ----------------- |
| Required permission | `work:write`      |
| Capability ID       | `statuses.create` |
| Destructive         | No                |

## Parameters [#parameters]

| Parameter   | Type                                                                | Required | Notes |
| ----------- | ------------------------------------------------------------------- | -------- | ----- |
| `name`      | string                                                              | yes      |       |
| `category`  | `BACKLOG` \| `UNSTARTED` \| `STARTED` \| `COMPLETED` \| `CANCELLED` | yes      |       |
| `color`     | string                                                              | no       |       |
| `position`  | integer                                                             | no       |       |
| `projectId` | string (uuid)                                                       | yes      |       |

## Input schema (JSON Schema) [#input-schema-json-schema]

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "category": {
      "type": "string",
      "enum": [
        "BACKLOG",
        "UNSTARTED",
        "STARTED",
        "COMPLETED",
        "CANCELLED"
      ]
    },
    "color": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "position": {
      "type": "integer"
    },
    "projectId": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "name",
    "category",
    "projectId"
  ],
  "additionalProperties": false
}
```

## Access control [#access-control]

A call succeeds only when the personal access token's scopes **and** the holder's role both allow `work:write` (effective permission = scope ∩ role, default-deny). The tool runs inside the token owner's organization — tenancy is never a parameter.