Create Task

Creates a proposed or ready Task in a Room (room_id) or for a Business (business_id, expected_business_revision). Include a proposal_reason. For proposed Tasks, omit assignees, due_at and decision_reason.

Authorization

AuthorizationBearer <token>

Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.

In: header

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid

Idempotency-Key*string

Length8 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

business_id?string

Match^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$

room_id*string

Match^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$

expected_business_revision?integer

Range1 <= value

goal_id?|

Match^gol_[0-7][0-9A-HJKMNP-TV-Z]{25}$

title?string

Length1 <= length <= 300

description?|

Lengthlength <= 10000

status?string

Value in

"proposed"
"ready"

proposal_reason?string

Why this Task helps, grounded in the request or evidence.

Match\S

Length1 <= length <= 2000

proposal_evidence?array<unknown>

Itemsitems <= 100

decision_reason?|

Lengthlength <= 2000

assignee_user_id?|

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$

assignee_email?|

Formatemail

kind?string

Value in

"todo"
"request"
"upload"
"connect"
"answer"
"sign"
"approve"

due_at?|

Formatdate-time

Response Body

`application/json`

curl -X POST "https://example.com/v1/tasks" \  -H "SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Idempotency-Key: stringst" \  -H "Content-Type: application/json" \  -d '{    "title": "string",    "status": "proposed",    "proposal_reason": "string"  }'

{  "data": {    "task_id": "string",    "business_id": "string",    "room_id": "string",    "goal_id": "string",    "title": "string",    "description": "string",    "status": "proposed",    "proposal_source": "user",    "proposal_source_id": "string",    "proposed_by": {      "type": "user",      "id": "string"    },    "proposal_reason": "string",    "proposal_evidence": [      null    ],    "decision_reason": "string",    "assignee_user_id": "string",    "assignee_email": "user@example.com",    "kind": "todo",    "due_at": "2019-08-24T14:15:22Z",    "started_at": "2019-08-24T14:15:22Z",    "completion_evidence": [      null    ],    "completed_at": "2019-08-24T14:15:22Z",    "cancellation_reason": "string",    "canceled_at": "2019-08-24T14:15:22Z",    "revision": 1,    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  },  "receipt": {    "receipt_id": "64d0a161-468e-472a-b00e-a06ee9ab7de7",    "command_id": "7d510d78-7444-4252-aeac-9e473949661e",    "operation": "string",    "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9"  },  "idempotent_replay": true,  "request_id": "string"}

Create Task

Authorization

Header Parameters

Request Body

Response Body

200application/json

201application/json

400application/json

401application/json

403application/json

404application/json

409application/json

413application/json

415application/json

422application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`