Tickets
Create, update, search, and manage tickets across projects.
12 tools
# search_tickets
Search tickets by query, state, assignee, priority, type, or created/updated date range
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| q | string | — | Search query |
| project_id | string | — | Filter by project |
| state | string | — | Filter by state |
| assignee | string | — | Filter by assignee |
| priority | string | — | Filter by priority |
| created_after | string | — | Created at or after this date/timestamp (inclusive) |
| created_before | string | — | Created strictly before this date/timestamp (exclusive) |
| updated_after | string | — | Updated at or after this date/timestamp (inclusive) |
| updated_before | string | — | Updated strictly before this date/timestamp (exclusive) |
# get_ticket
Get a ticket by ID (UUID) or key (e.g. KERA-1)
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID or key |
# create_ticket
Create a new ticket in a project
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | ● | Project ID |
| type | string | ● | Ticket type |
| title | string | ● | Ticket title |
| body_md | string | — | Ticket body (markdown) |
| reporter_email | string | ● | Reporter email |
| assignee | string | — | Assignee email |
| priority | string | — | Priority level |
| workflow | string | — | Workflow the ticket follows (default: default) |
# update_ticket
Update a ticket's title, assignee, reporter, priority, or labels
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID (UUID) |
| title | string | — | New title |
| assignee | string | — | Assignee email (empty string to unassign) |
| reporter_email | string | — | Reporter email — must be an active workspace member. Empty or omitted leaves it unchanged; a reporter cannot be cleared. |
| priority | string | — | none|low|medium|high|urgent |
| labels | array | — | Free-form labels — replaces the full set. Omit to leave unchanged; empty array clears all. |
# transition_state
Transition a ticket to a new workflow state
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID |
| to_state | string | ● | Target state |
# list_tickets
List tickets with optional filters
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| project_id | string | — | Filter by project |
| state | string | — | Filter by state |
| labels_in | array | — | Filter to tickets carrying any of these labels |
| archived | boolean | — | Include archived |
| limit | integer | — | Max results |
| offset | integer | — | Offset |
# archive_ticket
Archive a ticket (soft delete)
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID |
# bulk_update_tickets
Bulk update tickets — set state or assignee for multiple tickets. Each ticket follows your workflow and permissions; any ticket that can't be changed is reported individually and left as it was
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_ids | array | ● | List of ticket IDs or keys (up to 200) |
| to_state | string | — | New state for all |
| assignee | string | — | New assignee for all |
# get_ticket_events
Get the event/activity history for a ticket
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID |
# get_ticket_relations
Get relations (blocks, relates_to, duplicates) for a ticket
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| ticket_id | string | ● | Ticket ID |
# add_ticket_relation
Add a relation between two tickets
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| from_ticket_id | string | ● | Source ticket ID |
| to_ticket_id | string | ● | Target ticket ID |
| relation_type | string | ● | blocks|relates_to|duplicates |
# remove_ticket_relation
Remove a ticket relation
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspace_id | string | ● | Workspace ID |
| from_ticket_id | string | ● | Source ticket ID |
| to_ticket_id | string | ● | Target ticket ID |
| relation_type | string | ● | blocks|relates_to|duplicates |