Post Form Steps Decision | HINDSITE

curl -X POST https://app.hindsiteind.com/api/v2/form_steps/decision \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "form_step_id": "string",
  "instruction_decision_id": "string",
  "next_instruction_step_id": "string",
  "decision_value": "string"
}'

{
  "id": "string",
  "instruction_step_id": "string",
  "form_id": "string",
  "started_at": 1,
  "next_instruction_step_id": "string",
  "decision_value": "string",
  "instruction_decisions_id": "string",
  "instruction_decision_id": "string",
  "decision_colour": "string",
  "flagged": true,
  "instruction_step_title": "string",
  "instruction_step_section_title": "string",
  "instruction_step_description": "string",
  "report_description": "string",
  "terminal": true,
  "completed_by_user_id": "string",
  "first_step": true,
  "defects_count": 1,
  "active_defects_count": 1,
  "inputs": [
    {
      "id": "string",
      "input": "string",
      "unformatted_date_input": "string",
      "selected_multi_options": [
        {
          "id": "string",
          "value": "string",
          "colour": "string",
          "instruction_option_id": "string"
        }
      ],
      "selected_input_records": [
        {
          "id": "string",
          "value": "string"
        }
      ],
      "failed_validations": [
        "string"
      ],
      "prefix": "string",
      "suffix": "string",
      "instruction_input_title": "string",
      "instruction_input_type": "string",
      "instruction_input_id": "string",
      "attachments": [
        {
          "id": "string",
          "content": {
            "id": "string",
            "original": "string",
            "versions": [
              "string"
            ],
            "thumbnails": [
              "string"
            ],
            "title": "string"
          },
          "excluded_from_export": true
        }
      ],
      "form_step_id": "string",
      "created_at": 1,
      "updated_at": 1
    }
  ],
  "actions": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "status": "string",
      "priority": "string",
      "actionable_type": "string",
      "actionable_id": "string",
      "assigned_to_id": "string",
      "user_id": "string",
      "organisation_id": "string",
      "due_date": 1,
      "completed_at": 1,
      "notes": [
        {
          "id": "string",
          "content": "string",
          "plain_text_content": "string",
          "user": {
            "id": "string",
            "email": "string",
            "name": "string",
            "is_admin": true,
            "location_manager": true,
            "last_active_at": 1,
            "archived": true,
            "organisation_id": "string",
            "created_at": 1,
            "updated_at": 1
          },
          "noteable_type": "string",
          "noteable_id": "string",
          "attachments": [
            null
          ],
          "created_at": 1,
          "updated_at": 1
        }
      ],
      "user": {
        "id": "string",
        "email": "string",
        "name": "string",
        "is_admin": true,
        "location_manager": true,
        "last_active_at": 1,
        "archived": true,
        "organisation_id": "string",
        "created_at": 1,
        "updated_at": 1
      },
      "contents": [
        {
          "id": "string",
          "original": "string",
          "versions": [
            "string"
          ],
          "thumbnails": [
            "string"
          ],
          "title": "string"
        }
      ],
      "assigned_to": {
        "id": "string",
        "name": "string"
      },
      "created_at": 1,
      "updated_at": 1
    }
  ],
  "comment": {
    "id": "string",
    "description": "string",
    "user": {
      "id": "string",
      "email": "string",
      "name": "string",
      "is_admin": true,
      "location_manager": true,
      "last_active_at": 1,
      "archived": true,
      "organisation_id": "string",
      "created_at": 1,
      "updated_at": 1
    },
    "created_at": 1,
    "updated_at": 1
  },
  "completed_by_user": {
    "id": "string",
    "email": "string",
    "name": "string",
    "is_admin": true,
    "location_manager": true,
    "last_active_at": 1,
    "archived": true,
    "organisation_id": "string",
    "created_at": 1,
    "updated_at": 1
  },
  "created_at": 1,
  "updated_at": 1
}

Authentication

AuthorizationBearer

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

Request API credentials from HINDSITE support to receive your client_id and client_secret
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

The response will contain your access token:

1 {
2   "access_token": "your_access_token_here",
3   "token_type": "Bearer",
4   "expires_in": 7200,
5   "created_at": 1234567890
6 }

Include the token in subsequent API requests:

Authorization: Bearer your_access_token_here

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 ``` 3. The response will contain your access token: ```json { "access_token": "your_access_token_here", "token_type": "Bearer", "expires_in": 7200, "created_at": 1234567890 } ``` 4. Include the token in subsequent API requests: ``` Authorization: Bearer your_access_token_here ```

Request

This endpoint expects an object.

form_step_idstringRequired

instruction_decision_idstringRequired

next_instruction_step_idstringRequired

decision_valuestringRequired

decision_colourstringOptional

Response

created Decision

idstring

ULID

instruction_step_idstring

ULID

form_idstring

ULID

started_atlong

Unix timestamp (seconds since epoch)

next_instruction_step_idstring

ULID

decision_valuestring

instruction_decisions_idstring

ULID. Deprecated, use instruction_decision_id

instruction_decision_idstring

ULID

decision_colourstring

flaggedboolean

instruction_step_titlestring

instruction_step_section_titlestring

instruction_step_descriptionstring

report_descriptionstring

terminalboolean

completed_by_user_idstring

ULID

first_stepboolean

defects_countinteger

active_defects_countinteger

inputslist of objects

actionslist of objects

commentobject

completed_by_userobject

created_atlong

Unix timestamp (seconds since epoch)

updated_atlong

Unix timestamp (seconds since epoch)

1	{
2	"access_token": "your_access_token_here",
3	"token_type": "Bearer",
4	"expires_in": 7200,
5	"created_at": 1234567890
6	}