Create task
create_taskCreate a task after the user has specified the target project and intended task. The connected user is assigned by default; assigneeIds overrides this, and [] leaves the task unassigned. Only set dates, priority, list or assignees when requested. Use content for Markdown or description for the legacy body, never both. Initial status must belong to the project. Attaching existing files additionally requires files:write. figmaDesigns embeds the designs and links Resources. If resources are pending, report the created task and retry this exact requestId on the same connection to finish linking, never create a replacement.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"requestId": "<requestId>",
"projectId": "<projectId>",
"name": "<name>"
},
"name": "create_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The name requested by the user. For updates, omit to keep the current name. | |
| listId | No | Optional existing task list ID in the destination project. | |
| content | No | Initial Doc body as Markdown, at most 20,000 characters. | |
| fileIds | No | Up to 20 existing accessible file IDs to attach. Requires files:write as well as tasks:write. | |
| deadline | No | ISO 8601 deadline including a timezone offset. Omit to leave unchanged; null clears the deadline. | |
| priority | No | Priority: 0 Low, 1 Normal, 2 High, 3 Urgent. For updates, null clears it. | |
| projectId | Yes | Existing accessible project ID returned by list_projects. | |
| requestId | Yes | A unique UUID for this intended action. Reuse it unchanged when retrying the same action. | |
| startDate | No | ISO 8601 start date with timezone. Omit to preserve; null clears it. | |
| assigneeIds | No | Full replacement list of existing project member IDs from list_project_members. [] unassigns everyone; omit to preserve. | |
| description | No | Optional text for the new task or the initial project document. | |
| figmaDesigns | No | Selected Figma designs to embed automatically; tasks also add them to Resources. Use content for Markdown, not legacy description. Ask for the design link if unavailable. Does not write back into Figma. | |
| stateProjectId | No | Task status ID from list_project_statuses for the destination project. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | ||
| figma | No |