Create Task
Adds a Task in a Room (room_id) or for a Business (business_id, expected_business_revision). Status is not_started (default) or recommended. Add why to say why it helps. For many, send tasks (up to 1,000) instead of title; goal makes a new goal for them (goals:write too). All or nothing, one receipt; returns task_ids in order. A refused Task: details.task_index.
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
SMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
uuidIdempotency-Key*string8 <= length <= 200application/json- body
business_id?SmbV0OperationsSetWorkspaceFieldValueRequestBusinessId^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$room_id*string^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$expected_business_revision?integer1 <= valuegoal_id?|^gol_[0-7][0-9A-HJKMNP-TV-Z]{25}$title?string1 <= length <= 300description?|length <= 10000status?stringrecommended suggests it to someone; not_started is the default.
"recommended""not_started"why?|Why this Task helps (shown as Why).
\S1 <= length <= 2000assignee_user_id?|^[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?|emailassignee_rule?|Room tasks: link_opener = whoever opens a link that starts from this Room. Not with an assignee.
"link_opener"nulldue_at?|date-timeupload_folder_id?|Room tasks: folder for its uploads.
^rfd_[0-7][0-9A-HJKMNP-TV-Z]{25}$visibility?stringRoom tasks: who sees it (default inherit).
"only_me""people""workspace""room""inherit"goal?tasks?array<>1 to 1,000 Tasks, created in this order.
1 <= items <= 1000The existing resource or idempotent replay was returned.
application/json- response
data*|receipt*idempotent_replay*smb_v0_operations_create_list_request.__local.properties.body.__schema16request_id*stringcurl -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 '{}'{ "data": { "task_id": "string", "business_id": "string", "room_id": "string", "goal_id": "string", "upload_folder_id": "string", "title": "string", "description": "string", "status": "recommended", "created_by": { "type": "user", "id": "string" }, "why": "string", "source": { "type": "user", "id": "string" }, "assignee_user_id": "string", "assignee_email": "user@example.com", "assignee_rule": "link_opener", "due_at": "2019-08-24T14:15:22Z", "started_at": "2019-08-24T14:15:22Z", "done_at": "2019-08-24T14:15:22Z", "archived_at": "2019-08-24T14:15:22Z", "archive_reason": "string", "done_with": [ null ], "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"}