---
title: "Workflow Status Update"
method: POST
path: "/WORKFLOW_STATUS_UPDATE"
tags: ["Agent Activity"]
---

# Workflow Status Update

`POST /WORKFLOW_STATUS_UPDATE`

## Request

- Base URL: `https://apidocs.goaugment.com` (the document declares no server; this is the origin it was published from)
- URL: `https://apidocs.goaugment.com/WORKFLOW_STATUS_UPDATE`
- Auth: none declared
- TypeScript: <https://skmtc.dev/goaugment/apis/webhooks/docs/WORKFLOW_STATUS_UPDATE/post.ts> (a function with typed inputs; its response is checked against the schema)

> v1 equivalent: none. v2 only.

Sent when an Augment agent workflow on one of your loads changes state — for example when it completes, is canceled, escalates to a human, or errors. Use it to mirror agent progress in your TMS.

`statusReasonCode` is free-form and workflow-specific; treat it as an open set and do not branch on values you have not agreed with Augment.

## Request body

- WorkflowStatusUpdateEvent: Fields present on every v2 webhook event.
  - `id` string, required: Unique event identifier (ULID)
  - `workflow` 'TRACK_AND_TRACE' | 'CARRIER_SUPPORT' | 'POD_COLLECTION' | 'LOAD_BUILDING' | 'CARRIER_SELECTION' | 'SCHEDULING' | 'CUSTOMER_SUPPORT' | 'null', nullable, required: The Augment workflow that produced this event, or `null` when no single workflow can be attributed. New values may be added over time, so treat this as an open set rather than a fixed list.
  - `occurredAt` string, date-time, required: When the underlying activity occurred (ISO 8601)
  - `loadNumber` string, nullable, required: Your load reference number
  - `customerLoadInternalId` string, nullable, required: Your internal load ID, if provided during load creation
  - `eventType` 'WORKFLOW_STATUS_UPDATE', required: Event name for a workflow status change.
  - `data` WorkflowStatusUpdateData, required: A state change on an Augment agent workflow running on this load.
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELED' | 'ESCALATED' | 'ERROR', required: The workflow's new status.
    - `agent` string: The agent whose workflow changed status, corresponding to the envelope's `workflow`. Treat as an open set — new agents may be added over time, so tolerate a value you have not seen before.
    - `context` string: Free-text explanation of the status change.
    - `statusReasonCode` string: Workflow-specific reason for the status change. Free-form and not a fixed vocabulary — treat as an open set and do not branch on values you have not agreed with Augment.

## Response `200`

Event acknowledged

---

[API](https://skmtc.dev/goaugment/apis/webhooks.md) - [All operations](https://skmtc.dev/goaugment/apis/webhooks/llms.txt) - [OpenAPI document](https://skmtc.dev/goaugment/apis/webhooks/revisions/a074b2ada419?raw)