Tasks Field Reference

Use this reference when creating, updating, importing, grouping, or drafting Copilot actions for tasks.

Required Fields

Field	Type	Notes
Title	Text	Required. Maximum 500 characters.
Project	Project select	Required on create.

Common Fields

Field	Type	Notes
Description	Textarea	Optional.
Phase	Phase select	Optional, project-scoped.
Milestone	Milestone select	Optional, project-scoped.
Parent task	Task select	Optional.
Status	Select	Defaults by service/UI when omitted.
Priority	Select	Defaults by service/UI when omitted.
Start date	Date	Optional.
Due date	Date	Optional.
Estimated minutes	Number	0 is treated as empty.
Effort split mode	Select	equal or custom.
Requires approval	Boolean	Optional.
Visibility	Select	public, project, or internal.

Task Status Values

• todo
• in_progress
• in_review
• blocked
• done
• cancelled

Priority Values

• low
• medium
• high
• urgent

Approval Status Values

• not_required
• pending
• approved
• rejected

Assignee Role Values

• owner
• collaborator
• reviewer

Dependencies

Supported dependency values:

• finish_to_start
• start_to_start
• finish_to_finish
• start_to_finish

Task dependency creation currently creates finish-to-start dependencies from predecessor to successor. Lag days can offset the successor start from the predecessor due date.

Grouping Values

Tasks can be grouped by:

• status
• priority
• assignee
• completed
• submittedBy

Attachments

Task attachments can be:

• Uploaded resources by resourceId.
• External links by externalUrl.

Optional attachment label can be shown to users.

Copilot Notes

• For task creation, proposal fields should include project, title, priority, due date, assignee, and description when known.
• Project, assignee, phase, milestone, and parent task should be select fields, not free text.
• When user asks for best assignee by skill, resolve team member skills before drafting the task.
• If the user edits a draft task through chat, update the visible proposal fields.

Related Docs

• Tasks
• Projects Field Reference
• Resources Field Reference
• AI Proposals and Execution