Skip to navigation

Post Work Order Tasks Id Attachments

View as Markdown

Attaches files to a task from signed blob IDs obtained via the direct-upload flow.

Authentication

AuthorizationBearer

OAuth 2.0 Client Credentials Flow. To obtain an access token:

  1. Request API credentials from HINDSITE support to receive your client_id and client_secret

  2. Make a POST request to obtain an access token:

POST https://app.hindsiteind.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET
  1. The response will contain your access token:
{
  "access_token": "your_access_token_here",
  "token_type": "Bearer",
  "expires_in": 7200,
  "created_at": 1234567890
}
  1. Include the token in subsequent API requests:
Authorization: Bearer your_access_token_here

Path parameters

idstringRequired

Request

This endpoint expects an object.
attachmentslist of stringsRequired

Signed blob IDs from the direct-upload flow

Response

created Attachment
idstringOptional
ULID
titlestringOptional
instruction_idstring or nullOptional
ULID. Null for uninstructed tasks.
work_order_idstringOptional
ULID
sort_orderintegerOptional
flaggedbooleanOptional
published_instruction_revision_idstringOptional
ULID
userslist of objectsOptional
started_atlong or nullOptional

Unix timestamp (seconds since epoch); null until the task is started

completedbooleanOptional
approvedbooleanOptional
asset_idstringOptional
ULID
assetobject or nullOptional

Only present when include_asset=true is requested on the parent work order, and on POST /api/v2/my_work/search; null when the task has no asset. When the work order has an asset, every task carries that same asset and it cannot be changed per task; tasks only carry their own assets on a work order with no asset.

tracked_timeintegerOptional
defects_countintegerOptional
active_defects_countintegerOptional
started_byobjectOptional
editablebooleanOptional
reviewerslist of objectsOptional
formobjectOptional
published_instruction_revisionobjectOptional
positionintegerOptional
planned_start_atlongOptional
planned_finish_atlongOptional
scheduled_atdatetime or nullOptional

The task’s start, the earlier of planned_start_at and started_at, as ISO 8601 in its work order’s location’s time zone (e.g. 2026-09-24T14:00:00.000+08:00 for 2pm in Perth); null when neither is set

locationobjectOptional

The location of the task’s work order. Returned by POST /api/v2/my_work/search.

work_orderobjectOptional

The task’s work order. Returned by POST /api/v2/my_work/search.

user_can_reviewbooleanOptional
attachmentslist of objectsOptional
custom_fieldslist of objectsOptional

Present when include_custom_fields=true is requested, and always on the POST /api/v2/work_order_tasks response.

custom_field_definitionslist of objectsOptional

Present when include_custom_fields=true is requested, and always on the POST /api/v2/work_order_tasks response. The organisation’s definitions for work order tasks; empty when it has none.

accepts_reviewsbooleanOptional
Whether reviews can be submitted right now
reviews_viewablebooleanOptional

Whether the reviews panel applies. Returned with include_reviewers.

potential_reviewerslist of objectsOptional

Users who can be requested as reviewers. Returned with include_reviewers.

reviewable_bybooleanOptional

Whether the caller can review. Replaces the deprecated user_can_review.

review_validationslist of objectsOptional

Reasons the caller cannot review yet; empty when they can. Returned with include_reviewers.

can_manage_reviewersbooleanOptional

Whether the caller can add or remove reviewers. Returned with include_reviewers.

external_review_validationslist of objectsOptional

Reasons an external review cannot be requested yet. Returned with include_reviewers.

external_reviews_offeredbooleanOptional

Whether the caller can request an external review. Returned with include_reviewers.

requestable_external_reviewerslist of objectsOptional

External reviewers the caller can request. Returned only when external_reviews_offered is true.

work_order_section_idstringOptional
ULID of the section the task sits in
created_atlongOptional

Unix timestamp (seconds since epoch) when the record was created

updated_atlongOptional

Unix timestamp (seconds since epoch) when the record was last updated