Report an outcome

Report an Outcome when you want to record what your product or review team did after receiving a Dockt Decision. An Outcome is separate from the immutable Decision.

Prerequisites

You need the Decision ID your workflow acted on and a workspace credential with decisions:outcome.

Create the Outcome

Send the observed result, its timestamp, and a stable name for your source system:

export DOCKT_API_BASE_URL='https://api.dockt.com'
export DOCKT_API_TOKEN='REPLACE_WITH_BEARER_TOKEN'
export DOCKT_DECISION_ID='dec_REPLACE_ME'

curl --fail-with-body --silent --show-error \
  -X POST "$DOCKT_API_BASE_URL/v1/decisions/$DOCKT_DECISION_ID/outcome" \
  -H "Authorization: Bearer $DOCKT_API_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{
    "outcome": "manual_review",
    "observed_at": "2026-08-06T10:15:00Z",
    "source_system": "contractor-portal",
    "notes": "Reviewer requested an updated document."
  }' | jq

Supported Outcome values are accepted, rejected, follow_up_requested, manual_review, and unknown.

Use the time the Outcome happened in observed_at, not the time your integration sends the request.

Read the Outcome

Fetch the recorded Outcome:

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $DOCKT_API_TOKEN" \
  "$DOCKT_API_BASE_URL/v1/decisions/$DOCKT_DECISION_ID/outcome" | jq

A 404 Not Found means no Outcome has been reported for that Decision.

Preserve the original Decision

Reporting an Outcome doesn’t change Decision Facts, Findings, requirements, or evidence lineage. If new worker input or evidence changes the Assessment, Dockt creates a separate Decision. Report the Outcome against the exact Decision ID your system handled.