Search Documentation
Search across all documentation pages
create_task
Create a new task on the kanban board. Tasks are stored as memories with memoryType='task'. Supports status tracking, priority levels, agent assignment, and natural language completion criteria for auto-detection.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string (1-500 chars) | required | Task title (plaintext -- encrypted before storage) |
| description | string (max 5000 chars) | optional | Optional task description (plaintext -- encrypted before storage) |
| vaultId | string (UUID) | optional | Vault to scope the task to. Defaults to defaultVaultId. |
| status | string | optional | Initial status: backlog, todo, in_progress, done, blocked (default: todo) |
| priority | integer (1-5) | optional | Priority 1-5 (5=critical). Defaults to 3. |
| agentId | string (max 200 chars) | optional | Agent that created this task |
| agentRunId | string (max 200 chars) | optional | Agent run/session ID |
| assignedAgentId | string (max 200 chars) | optional | Agent assigned to work on this task. Use any to let any agent pick it up. |
| doneWhen | string (max 1000 chars) | optional | Natural language completion criteria. When set, ExoVault can auto-detect task completion. |
Returns#
The created task object with its ID (memory ID), title, status, and priority.
Example#
json
{
"tool": "create_task",
"arguments": {
"title": "Implement OAuth2 token refresh",
"description": "Add automatic token refresh logic using the PKCE flow. Handle expired tokens gracefully with retry logic.",
"status": "todo",
"priority": 4,
"assignedAgentId": "claude_code",
"doneWhen": "Token refresh works automatically when access token expires, with proper error handling and retry logic"
}
}