GEgettruss
Tasks

Get task

Changed on

Returns full details on a task by task_id, including task-level and assignee task file attachments.

get/projects/{project_id}/tasks/{id}

Request

  • Base URL
    https://app2.gettruss.io/api/v1
  • URL
    https://app2.gettruss.io/api/v1/projects/{project_id}/tasks/{id}
  • Auth
    HTTP bearer

Path parameters

project_idinteger required

ID of the project

idinteger required

ID of the task

Query parameters

uploaded_by'client' | 'firm'

Filter attached_files by who uploaded them. "firm" returns only task-level files (uploaded by firm users), "client" returns only assignee task files (uploaded by clients). Omit to return both.

Response

successfully returns the task

idinteger
namestring

Name of the task

descriptionstring

Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>.

description_as_stringstring

Plain text description of the task

status'to_do' | 'pending_review' | 'approved'

Status of the task

due_datestring date-time nullable

When the task is due (ISO 8601). Null when no due date is set.

task_typestring nullable

The task's type - see Task types. Null for a plain task.

amount_duestring nullable

Invoice tasks only. Amount the client owes, in dollars.

verification_typesstring[] nullable

contact_info_verification tasks only. What the client is asked to confirm.

payment_status'unpaid' | 'payment_pending' | 'paid' nullable

Invoice tasks only. "payment_pending" is an ACH payment Stripe has accepted but not yet settled; it can still fail and revert the task to unpaid.

created_atstring date-time
updated_atstring date-time

Changes