Skip to navigation
HINDSITE APIreviews

Post Work Orders Id Reviews

View as Markdown

Submits the caller’s review (approve, reject or comment) on a work order, adding the caller as a reviewer if they were not one already; only admins, the work order’s assigned managers and leads, location managers and its creator may call it, and approving or rejecting needs the work order to be completed.

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.
statusenumRequired

approved or rejected records a decision; comment leaves a comment without changing the decision

Allowed values:
commentstringOptional

Required when status is comment

Response

The created review
idstringOptional
ULID
statusenumOptional
Allowed values:
commentstring or nullOptional
null when the review was submitted without a comment
created_atdatetimeOptional
ISO 8601
updated_atlongOptional

Unix timestamp (seconds since epoch)

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error