Builder.io Tasks Action Reference
The compact index in AGENTS.md lists action names and purposes. This is the
full table, including the HTTP method each action is exposed under. The
canonical descriptions and input schemas live in actions/.
| Action | Method | Purpose |
|---|---|---|
list-tasks |
GET | List current user's tasks; includeDone and includeFields default to false |
create-task |
POST | Create a task with title |
update-task |
POST | Patch title, done, and/or fieldValues by taskId |
delete-task |
POST | Delete a task by taskId (confirm with user first) |
bulk-update-tasks |
POST | Patch title and/or done on multiple tasks by id |
bulk-delete-tasks |
POST | Delete multiple tasks by id (confirm with user first) |
reorder-tasks |
POST | Reorder visible tasks by id list top-to-bottom |
list-inbox-items |
GET | List current user's inbox items |
create-inbox-item |
POST | Create a not-ready inbox item with title (default chat capture) |
update-inbox-item |
POST | Patch inbox item title by inboxItemId |
delete-inbox-item |
POST | Delete an inbox item (confirm with user first) |
bulk-delete-inbox-items |
POST | Delete multiple inbox items by id (confirm with user first) |
mark-inbox-item-ready |
POST | Promote inbox item to an incomplete task |
bulk-mark-inbox-items-ready |
POST | Promote multiple inbox items to incomplete tasks by id |
reorder-inbox-items |
POST | Reorder inbox items by id list top-to-bottom |
list-custom-fields |
GET | List custom field definitions |
create-custom-field |
POST | Create a custom field definition with title, type, and optional config |
update-custom-field |
POST | Patch a field definition title and/or type-compatible config; type is immutable |
delete-custom-field |
POST | Delete a field definition and its values on every task (confirm with user first) |
reorder-custom-fields |
POST | Reorder custom field definitions by id list top-to-bottom |
list-visible-task-fields |
GET | List custom field ids shown on task cards for the current user |
update-visible-task-fields |
POST | Replace which custom fields appear on task cards (max 3) |
view-screen |
— | Read navigation, UI bulk selection, visible tasks, and inbox snapshot |
navigate |
— | Move UI to a view: tasks, inbox, fields, extensions, team (home/ask → tasks) |
render-task-list-inline |
— | Render an interactive task-list widget inline in chat without leaving the current view |
Related Skills
- task-inbox-workflow — when to call the task and inbox actions.
- custom-fields — the custom field definition, value, and visibility actions.
- actions — how to create a new action with
defineAction.