create_ticket
Create a ticket in a project. Use this whenever the user asks you to create, file, log or record a ticket (bug, backlog item, follow-up, feature request) for a project.
A ticket is a row in the project's "Tickets" datastore (columns Title, Description, Status, Priority, Created) on the project's protected Tickets page. This tool finds that page from any page in the project and creates the datastore with the standard columns if it does not exist yet.
Never write a ticket as a text, checklist or task block on the Tickets page: agents are rejected there, and such blocks do not appear in the ticket views.
Not for: items on the Agent Tasks list (add_ctlsurf_task_item), or Business change orders / proposals / SOWs (dashboard cards, load_toolset("dashboards")).
Put the full ticket body (problem, scope, acceptance criteria, links) in description as markdown.
Example: create_ticket(page_id="", title="Retry failed uploads", description="## Problem\n...", priority="High")
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": {
"page_id": "<page_id>",
"title": "<title>"
},
"name": "create_ticket"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Short one-line ticket title (max 240 chars) | |
| status | No | Default Open | |
| page_id | Yes | Any page in the project: its Tickets page, the project root page, or any page under it. Find the root with find_page_by_root_path(root_path=<repo path>) if you have no page id. | |
| priority | No | Default Med | |
| description | No | Full ticket body in markdown (max 10,000 chars) |