GEgettruss
Tasks

Add files to task

Changed on

Upload files to a task. Files attach at the task level (task.files, i.e. firm-uploaded files, listed in attached_files with uploaded_by=firm). Provide either a publicly accessible URL for Truss to download, or a signed_id from POST /projects/{project_id}/tasks/direct_upload after uploading the file bytes directly to cloud storage. Requires the files_write scope, plus files_read because the response includes presigned download URLs.

post/projects/{project_id}/tasks/{id}/add_files_to_task

Request

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

Path parameters

project_idinteger required

ID of the project

idinteger required

ID of the task to attach files to

Request body

Response

Files added to task successfully; returns the task with its attached_files

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