Playground

Playground

Task

/api/v1/edm-projects/tasks

A unit of work within a Project.

listgetcreateupdatedelete

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
project_idstringParent project ID. Format: prj-<uuid>.
parent_task_idstringParent task ID for subtask hierarchies.
sprint_idstringSprint ID if this task is committed to a sprint.
feature_idstringFeature ID if this task is grouped under a feature.
titlestringShort descriptive title for the task.
descriptionstringDetailed task description. Supports Markdown.
task_numberstringHuman-readable task number scoped to the project key.
statusstringCurrent task status.
prioritystringTask priority level.
story_pointsnumberAgile story point estimate.
estimated_hoursnumberEstimated hours to complete.
actual_hoursnumberActual hours logged against this task.
assignee_idstringUser ID of the assignee. Format: usr-<uuid>.
reviewer_idsjsonUser IDs of reviewers.
labelsjsonFree-form label strings for categorisation.
due_datedate-timeTask due date.
completed_atdate-timeISO 8601 timestamp when the task was completed.
blocked_by_task_idsjsonTask IDs that must be completed before this task can proceed.
duplicates_task_idstringTask ID that this task duplicates.
repository_refjsonLinked pull request or branch reference.
comment_countnumberNumber of comments on this task.
attachment_refsjsonReferences to attached files.
custom_fieldsjsonArbitrary key-value extension fields.
tagsjsonFlat string tags for filtering and grouping.
versionnumberOptimistic-concurrency version counter.
start_datedate-timeTask start date.
estimate_hoursnumberEffort estimate in hours.

API

client.projects.tasks.*
Loading manifest…