Create Subtask
POST /tasks/{task_id}/subtasks
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.
Authorizations
Parameters
Path Parameters
Parent task id (UUID).
Parent task id (UUID).
Header Parameters
Request Body required
Create a subtask under an existing task.
entity_type/entity_id are the record the subtask hangs off, and they
are required by the app’s own model - a subtask is not implicitly attached
to its parent’s record.
object
Record id.
Record type: contact | company | deal.
object
Subtask title.
Responses
201
Successful Response
object
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”.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error