Create Goal
POST
Creates a desired Business outcome, or a goal in a Room (room_id), with a measurable title and optional owner and due date. When you suggest several steps toward one outcome, send them as tasks so the person approves them together: up to 10, made ready with the goal in one write (tasks:write and goals:read too); assignee you is the caller, smb is left unassigned for SMB to draft. Returns an action receipt, plus task_ids in order.
header
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.
Format
uuidIdempotency-Key*stringLength
8 <= length <= 200application/json- body
business_id*SmbV0OperationsGetBusinessComparablesRequestBusinessIdStable SMB Business ID.
Match
^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$expected_business_revision*integerRange
1 <= valueroom_id?stringRoom to put it in, instead of a Business.
Match
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$title?stringLength
1 <= length <= 300description?|Length
length <= 10000accountable_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}$due_at?|Format
date-timetasks?array<>Items
1 <= items <= 10The 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/goals' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Idempotency-Key: stringst' \ -H 'Content-Type: application/json' \ -d '{ "title": "string"}'{ "data": { "goal_id": "string", "business_id": "string", "room_id": "string", "title": "string", "description": "string", "status": "active", "accountable_user_id": "string", "due_at": "2019-08-24T14:15:22Z", "terminal_reason": "string", "completed_at": "2019-08-24T14:15:22Z", "canceled_at": "2019-08-24T14:15:22Z", "created_by": { "type": "user", "id": "string" }, "revision": 1, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "task_ids": [ "string" ] }, "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"}