← API Index
/api/admin/kanban/ticket/new
Creates a new ticket on a board and returns it
Parameters
| Name |
Description |
Type |
| title |
ticket title (required) |
string |
| board_id |
board id (required) |
int |
| who |
creator name, default 'unknown' |
string |
| state |
initial state, default 'inbox' |
string |
| description |
ticket description (markdown) |
string |
| start_dt |
start date (YYYY-MM-DD HH:MM:SS or ISO 8601), default NOW() |
string |
| end_dt |
end date (YYYY-MM-DD HH:MM:SS or ISO 8601) |
string |
| sorting |
sort order within state, lower = higher priority |
int |
| background_color |
card background color (hex or CSS name), empty = default |
string |
| oo-rf |
optionally define the response-format for this call. One of: compact (default) | compacts | full | fulls | json | md | html | js | openapi | yaml |
String |
| oo-auth |
optionally force the API to check against the role (instead of silently not returning data). For guests or public access, the default is -1. 0 (regular customer) and above define the role for which the current session is expected to be authorized. |
int |
Error Responses
| HTTP Status |
Error Code |
Description |
| 400 |
parameter_error |
Missing or invalid parameters |
Response Types
| Type |
Version |
Description |
| TicketResult |
1 |
Result of a ticket/kanban mutation (board, state, ticket or detail operation) |
| Ticket |
2 |
A ticket within a board, ordered by sorting then start date descending |
OpenAPI
See new.yaml
Referenced in skills