Alpha APIActions

Add Task

View as Markdown

Create a task on the vault’s board. The owner may be a person’s name or a company placeholder. Supports the full kanban surface: t-shirt estimate, priority, labels, checklist, due date and milestone (resolve ids with list_milestones). Requires a manager API key.

Authentication

AuthorizationBearer
Create a personal key in Alpha settings, or use an access token issued to an approved OAuth client.

Request

This endpoint expects an object.
titlestringRequired

Short actionable title (short and actionable)

vaultstringOptional

Exact vault id or name from list_vaults. Required whenever the key can reach more than one vault; never guess or use one client’s vault for another.

descriptionstringOptional
Optional detail
assigneeNamestringOptional
Responsible person or company
estimateenumOptional

T-shirt effort size

Allowed values:
priorityenumOptional
Allowed values:
labelslist of stringsOptional
checklistlist of objectsOptional
dueDatestringOptional

ISO date, e.g. 2026-08-15

milestoneIdstringOptional

Milestone id from list_milestones

Response headers

X-Request-IdstringOptional
Stable identifier for tracing this request in Alpha logs.

Response

Add Task completed.
datamap from strings to any or list of maps from strings to any
The result returned by the selected Alpha tool.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error