Manage projects
manage_projectsCreate, update, archive or delete a project, and set or delete its key/value fields (owner contact, region, runbook link). Environments and deployment URLs change through manage_environments, secrets through manage_secrets, members through manage_members. Actions (arguments besides action):
create (name; optional slug, description): a project with development, preview and production environments, owned by the person behind this token. The slug is made from the name when omitted and never changes.
update (project; name and/or description): name changes the display name only, so the slug and every reference to it stay; description null clears it.
archive / unarchive (project): archived projects are read-only for every member and token while reads keep working; repeating either is harmless (changed: false).
delete (project, reason; optional answer_within): deletes nothing itself. It files a request, showing your reason, that the owner confirms in the web app with a second factor within answer_within minutes, or it expires and nothing changes; the server then deletes the archived project with all its secrets, files, logins and history. Show approveUrl to the user and follow it with get_access_requests. Archive first: that can be undone, deleting cannot.
set_field (project, key, value; optional sensitive): creates the field or replaces its whole value; a sensitive one is masked, and get_project returns it only to a token that may read secrets. delete_field (project, key): removes it. Fields keep no history. Errors are messages: a slug in use, an archived project (only archive, unarchive and delete pass), for delete a project that is not archived, a CI job's token or a protected project, a protected project for sensitive fields, an unknown field, and, where billing is on, an organisation not on Pro or over its credit limit. Audited. Needs projects:write, plus: for create, a token that reaches all projects; for update, archive, unarchive and delete, the owner role; for fields, the editor role (and secrets:write for a sensitive one).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_projects"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | set_field, delete_field: the field name, up to 80 characters, e.g. owner or region, as get_project lists it | |
| name | No | create: required display name, 1 to 80 characters. update: the new display name | |
| slug | No | create only: URL slug of lowercase letters, digits and dashes, up to 48 characters, e.g. my-app. Made from the name when omitted | |
| value | No | set_field only: the field value, up to 16 KB | |
| action | Yes | What to do | |
| reason | No | delete only: one sentence the owner reads when confirming, 3 to 300 characters: why the project should go | |
| project | No | Project slug (my-app) or id (a UUID). Every action but create | |
| sensitive | No | set_field only: mask the value and treat it like a secret (default: keep the field's current setting, false for a new one) | |
| description | No | create, update: description, up to 500 characters; null clears it (update only) | |
| answer_within | No | delete only: minutes the owner has to confirm (1 to 60, default 10) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | create, update: the project id | |
| key | No | set_field, delete_field: the field's key | |
| name | No | create, update: the project's display name | |
| next | No | delete (manage_projects), invite, set_role, remove: what to do next | |
| slug | No | create, update: the project's slug | |
| action | No | delete (manage_projects), invite, set_role, remove: the change the owner is asked to confirm (kind, plus email, userId and role where they apply) | |
| status | No | delete (manage_projects), invite, set_role, remove: always "pending" here | |
| changed | No | archive, unarchive: false when the project was already in that state | |
| created | No | set_field: true when the field is new | |
| deleted | No | delete_field: true once the field is gone | |
| project | No | archive, unarchive: the project's slug | |
| request | No | delete (manage_projects), invite, set_role, remove: the request id to pass to get_access_requests | |
| answerBy | No | delete (manage_projects), invite, set_role, remove: when the request expires unanswered | |
| archived | No | archive, unarchive: whether the project is archived now | |
| sensitive | No | set_field: whether the field is masked | |
| approveUrl | No | delete (manage_projects), invite, set_role, remove: show this to the user; they confirm there with a second factor | |
| description | No | update: the description now stored; null when cleared | |
| environments | No | create: the project's starting environments |