---
title: "Dispute an outcome subject"
method: POST
path: "/v1/outcomes/disputes"
---

# Dispute an outcome subject

`POST /v1/outcomes/disputes`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/outcomes/disputes`
- Auth: HTTP bearer

Organization API key with decision:write and role ADMIN or higher. While the dispute is open, or once it is upheld, the subject counts as disputed in every statement and in no charge. A dispute opened after a month closed reaches the next statement as a correction. One open dispute per subject (409 outcome_dispute_open); a subject the meter has never seen is 404.

## Request body

- object
  - `subject_digest` string, required
  - `reason` string, required

## Response `201`

The open dispute.

- OutcomeDispute
  - `dispute_id` string, uuid, required
  - `subject_digest` string, required
  - `reason` string, required
  - `opened_at` string, date-time, required
  - `state` 'OPEN' | 'UPHELD' | 'REJECTED', required
  - `resolution_note` string, nullable, required
  - `resolved_at` string, date-time, nullable, required

## Other responses

- `400`: Structured API error
- `403`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `503`: Structured API error

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)