Docs Reference

Subtasks

A project’s checklist: list, add, update and complete.

soontra_subtasks_list

  • Scope read
  • Read-only

List a project's subtasks (name, priority, due_date, completed_at, recurrence).

Parameters of soontra_subtasks_list
ParameterTypeDescription
project_idrequiredstring (uuid)

Returns The project's subtasks and their count.

  • Returns at most 20 subtasks and cannot page.
  • Ordered by position in the project.
  • assignee_ids are included only when the credential also has the directory scope.

soontra_subtasks_bulkComplete

  • Scope write
  • Writes

Complete (or un-complete) up to 100 subtasks by id (duplicates are deduped; ids that match nothing come back in not_found). Completing recurring subtasks spawns their next occurrences. Consumes one write token per row (60/min budget, single-call debit capped at 50).

Parameters of soontra_subtasks_bulkComplete
ParameterTypeDescription
subtask_idsrequiredstring (uuid)[]1 to 100 items
completedrequiredboolean
idempotency_keystringUnique key for this logical mutation. Reuse only to retry the exact same payload. 1-128 chars: A-Z a-z 0-9 _ . : -

Returns The updated count, the completed value applied, the changed subtasks and any not_found ids.

  • Up to 100 ids a call; duplicates are removed.
  • Each id counts as one write, but one call takes at most 50 from the 60 a minute budget.

soontra_subtasks_bulkCreate

  • Scope write
  • Writes

Create up to 50 subtasks under one project in one call. Consumes one write token per row (60/min budget, single-call debit capped at 50; 1/row of the 500/day workspace budget).

Parameters of soontra_subtasks_bulkCreate
ParameterTypeDescription
project_idrequiredstring (uuid)
subtasksrequiredobject[]1 to 50 items
subtasks[].namerequiredstring1 to 200 characters
subtasks[].descriptionstringup to 1000 characters
subtasks[].priority"urgent" | "high" | "medium" | "low"
subtasks[].due_datestring | null
subtasks[].assignee_idsstring (uuid)[]up to 20 items
idempotency_keystringUnique key for this logical mutation. Reuse only to retry the exact same payload. 1-128 chars: A-Z a-z 0-9 _ . : -

Returns The created count and the new subtasks.

  • Up to 50 subtasks a call, all under one project.
  • Each subtask counts as one write against the rate limits.
  • Rows take no recurrence; use subtasks.create for a repeating subtask.

soontra_subtasks_create

  • Scope write
  • Writes

Add a subtask to a project (recurrence optional - same rule shape as projects; it respawns when completed). Writes are drafts-only: nothing is ever published, scheduled, or deleted by this tool.

Parameters of soontra_subtasks_create
ParameterTypeDescription
project_idrequiredstring (uuid)
namerequiredstring1 to 200 characters
descriptionstringup to 1000 characters
priority"urgent" | "high" | "medium" | "low"
due_datestring | null
assignee_idsstring (uuid)[]up to 20 items
recurrenceobject | null
recurrence.vrequired1
recurrence.freqrequired"daily"
recurrence.intervalrequiredinteger1 to 365
idempotency_keystringUnique key for this logical mutation. Reuse only to retry the exact same payload. 1-128 chars: A-Z a-z 0-9 _ . : -

Returns The new subtask with id, name, priority, due_date, completed_at and recurrence.

  • name is up to 200 characters and description up to 1,000.
  • Up to 20 assignees.

soontra_subtasks_update

  • Scope write
  • Writes

Update or complete a subtask (set completed for done; recurrence: null stops the repeat). Completing a recurring subtask auto-creates the next occurrence.

Parameters of soontra_subtasks_update
ParameterTypeDescription
project_idrequiredstring (uuid)
subtask_idrequiredstring (uuid)
namestring1 to 200 characters
descriptionstring | null
priority"urgent" | "high" | "medium" | "low"
due_datestring | null
assignee_idsstring (uuid)[]up to 20 items
completedboolean
recurrenceobject | null
recurrence.vrequired1
recurrence.freqrequired"daily"
recurrence.intervalrequiredinteger1 to 365
idempotency_keystringUnique key for this logical mutation. Reuse only to retry the exact same payload. 1-128 chars: A-Z a-z 0-9 _ . : -

Returns The updated subtask.

  • Pass at least one field besides project_id and subtask_id.
  • completed: true marks it done and completed: false reopens it.
  • description, due_date and recurrence accept null to clear them.