Tasks

Create Subtask

Create a subtask under this task.

entity_type / entity_id name the RECORD the subtask hangs off and are required - the parent supplies the hierarchy, not the record link. That record is authorised against the caller's contact, company and deal scopes, so a subtask cannot be attached to something the key cannot see.

parent_task_id in the body is ignored: the parent is the task in the path.

post/tasks/{task_id}/subtasks

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/tasks/{task_id}/subtasks
  • Auth: HTTP bearer

Path parameters

task_idstring required

Parent task id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

tagsstring[] nullable

Labels (max 20).

entity_typestring required

Record type: contact | company | deal.

entity_idstring required

Record id.

titlestring required

Subtask title.

descriptionstring nullable

Free-text body.

due_datestring nullable

ISO 8601 due date.

assignee_idstring nullable

Assignee id.

assignee_namestring nullable

Assignee display name.

priorityinteger nullable

Priority.

task_typestring nullable

Task type.

reminder_atstring nullable

ISO 8601 UTC reminder time. Omit for no reminder.

visibilitystring nullable

public | team | private. Omit for the org default.

recordsobject[] nullable

Additional {entity_type, entity_id} records to link. When set, the FIRST entry becomes the primary record.

source_urlstring nullable

Page the subtask was raised from.

parent_task_idstring nullable

Ignored - the parent is the task in the path. Present for parity.

subtask_sort_orderinteger nullable

Position among sibling subtasks.

Response

Successful Response

dataCrmRecordPayload required

An open envelope for one record, one dashboard or one job receipt.

Open because most of these reads are COMPUTED shapes - an engagement summary, a next-best-step, an intelligence status - that grow with the product, and dropping a field from an advisory read makes it say "nothing to report" rather than "we did not tell you".

Changes

No recorded changes to this operation across all 2 revisions of this API.