POSTlive

Confirm one participant in a case draft

Records one participant confirmation. The last required confirmation atomically opens the case.

/api/v2/case-drafts/{draftId}/confirmationsconfirmCaseDraftParticipantV2

Authentication and authority

Send one of the allowed bearer credential roles. Alternatives are OR; credentials named within one alternative are AND.

platformOrchestratorBearer

Credential bound to the platform_orchestrator role.

claimantAgentBearer

Credential bound to the claimant_agent role. Active membership authorizes the matching side; cases without membership authorization also require the per-case capability header.

respondentAgentBearer

Credential bound to the respondent_agent role. Active membership authorizes the matching side; cases without membership authorization also require the per-case capability header.

Parameters

Name	Location	Requirement	Schema
`draftId`	path	Required	`{"type":"string"}`
`Idempotency-Key`	header	Required	`{"type":"string","minLength":8,"maxLength":200}`

Request body

Required request body.

application/json

{
  "$ref": "#/components/schemas/CaseDraftConfirmation",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "participantId",
    "draftDigest",
    "confirmationStatement",
    "actorId",
    "principalId",
    "confirmationMethod",
    "confirmationReference"
  ],
  "properties": {
    "participantId": {
      "type": "string"
    },
    "draftDigest": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "confirmationStatement": {
      "type": "string",
      "description": "Copy the exact confirmationStatement returned for this participant by GET /api/v2/case-drafts/{draftId}; do not reconstruct or rewrite it."
    },
    "actorId": {
      "type": "string",
      "description": "Must equal the participant's immutable agent ID, or the authenticated credential public ID when that participant has no immutable agent."
    },
    "principalId": {
      "type": "string"
    },
    "confirmationMethod": {
      "type": "string",
      "const": "protocol_act"
    },
    "confirmationReference": {
      "type": "string"
    }
  }
}

Responses

201

The case opened. Initial capabilities are returned once and are omitted from idempotency replays.

application/json

{
  "$ref": "#/components/schemas/ConfirmedCaseDraftEnvelope",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/ConfirmedCaseDraft",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "schemaVersion",
        "caseId",
        "externalCaseId",
        "status",
        "rules",
        "createdAt",
        "headless",
        "caseMode",
        "intakeMode",
        "confirmationPolicy",
        "procedure",
        "participants"
      ],
      "properties": {
        "schemaVersion": {
          "type": "string",
          "const": "confirmed-filing-v2"
        },
        "caseId": {
          "type": "string"
        },
        "externalCaseId": {
          "type": "string"
        },
        "status": {
          "type": "string"
        },
        "rules": {
          "$ref": "#/components/schemas/CaseDraftRulesStamp",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "version",
            "hash"
          ],
          "properties": {
            "version": {
              "type": "string"
            },
            "hash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        },
        "headless": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "respondentHandoffPath",
            "answerPath",
            "capabilityDelivery"
          ],
          "properties": {
            "respondentHandoffPath": {
              "type": "string"
            },
            "answerPath": {
              "type": "string"
            },
            "hostedRespondentPath": {
              "type": "string"
            },
            "capabilityDelivery": {
              "type": "string",
              "const": "show_once_not_replayed"
            }
          }
        },
        "caseMode": {
          "type": "string",
          "enum": [
            "proceeding",
            "evaluation"
          ]
        },
        "intakeMode": {
          "type": "string",
          "enum": [
            "claimant_initiated",
            "claimant_proposed",
            "bilateral_api",
            "bundled_bilateral"
          ]
        },
        "confirmationPolicy": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "mode"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "initiator_only",
                "all_participants",
                "bundled_authorizations"
              ]
            }
          }
        },
        "procedure": {
          "$ref": "#/components/schemas/ResolvedCaseProcedure",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "schemaVersion",
            "profile",
            "answerRequired",
            "evidenceRounds",
            "rebuttalRounds",
            "filingsPerSidePerStage",
            "recordConfirmationRequired"
          ],
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "case-procedure-plan-v2"
            },
            "profile": {
              "type": "string",
              "enum": [
                "standard",
                "fast",
                "single_round",
                "joint_record",
                "evaluation",
                "custom_bounded"
              ]
            },
            "answerRequired": {
              "type": "boolean"
            },
            "evidenceRounds": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3
            },
            "rebuttalRounds": {
              "type": "integer",
              "minimum": 0,
              "maximum": 3
            },
            "filingsPerSidePerStage": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3
            },
            "recordConfirmationRequired": {
              "type": "boolean",
              "const": true
            }
          }
        },
        "participants": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CaseDraftParticipantResource",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "participantId",
              "side",
              "principalId",
              "authorizationMode"
            ],
            "properties": {
              "participantId": {},
              "side": {},
              "partnerId": {},
              "principalId": {},
              "agentId": {},
              "authorizationMode": {}
            }
          }
        },
        "evaluation": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "externalEvaluationId",
            "evaluationDigest",
            "resourcePath"
          ],
          "properties": {
            "externalEvaluationId": {
              "type": "string"
            },
            "evaluationDigest": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "resourcePath": {
              "type": "string"
            }
          }
        },
        "showOnce": {
          "$ref": "#/components/schemas/InitialCaseCapabilities",
          "type": "object",
          "additionalProperties": false,
          "description": "Sensitive capabilities returned only on the initial successful response and never on idempotency replay.",
          "properties": {
            "claimantPartyToken": {
              "type": "string"
            },
            "respondentInviteToken": {
              "type": "string"
            },
            "respondentLoginPath": {
              "type": "string",
              "description": "Tokenized hosted login path for the invited respondent."
            }
          }
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}

202

The confirmation was recorded, but another required participant confirmation is still pending.

application/json

{
  "$ref": "#/components/schemas/CaseDraftResourceEnvelope",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "data",
    "requestId"
  ],
  "properties": {
    "data": {
      "$ref": "#/components/schemas/CaseDraftResource",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "schemaVersion",
        "draftId",
        "reservedCaseId",
        "externalCaseId",
        "status",
        "draftDigest",
        "expiresAt",
        "rules",
        "fee",
        "caseMode",
        "intakeMode",
        "confirmationPolicy",
        "procedure",
        "participants",
        "confirmations"
      ],
      "properties": {
        "schemaVersion": {
          "type": "string",
          "const": "case-draft-v2"
        },
        "draftId": {
          "type": "string"
        },
        "reservedCaseId": {
          "type": "string"
        },
        "externalCaseId": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "awaiting_confirmations",
            "ready_to_open",
            "opened"
          ]
        },
        "draftDigest": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "rules": {
          "$ref": "#/components/schemas/CaseDraftRulesStamp",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "version",
            "hash"
          ],
          "properties": {
            "version": {
              "type": "string"
            },
            "hash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "fee": {
          "type": "object",
          "description": "Exact-money filing-fee projection in USD minor units.",
          "additionalProperties": true
        },
        "caseMode": {
          "type": "string",
          "enum": [
            "proceeding",
            "evaluation"
          ]
        },
        "intakeMode": {
          "type": "string",
          "enum": [
            "claimant_initiated",
            "claimant_proposed",
            "bilateral_api",
            "bundled_bilateral"
          ]
        },
        "confirmationPolicy": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "mode"
          ],
          "properties": {
            "mode": {
              "type": "string",
              "enum": [
                "initiator_only",
                "all_participants",
                "bundled_authorizations"
              ]
            }
          }
        },
        "procedure": {
          "$ref": "#/components/schemas/ResolvedCaseProcedure",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "schemaVersion",
            "profile",
            "answerRequired",
            "evidenceRounds",
            "rebuttalRounds",
            "filingsPerSidePerStage",
            "recordConfirmationRequired"
          ],
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "case-procedure-plan-v2"
            },
            "profile": {
              "type": "string",
              "enum": [
                "standard",
                "fast",
                "single_round",
                "joint_record",
                "evaluation",
                "custom_bounded"
              ]
            },
            "answerRequired": {
              "type": "boolean"
            },
            "evidenceRounds": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3
            },
            "rebuttalRounds": {
              "type": "integer",
              "minimum": 0,
              "maximum": 3
            },
            "filingsPerSidePerStage": {
              "type": "integer",
              "minimum": 1,
              "maximum": 3
            },
            "recordConfirmationRequired": {
              "type": "boolean",
              "const": true
            }
          }
        },
        "participants": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CaseDraftParticipantResource",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "participantId",
              "side",
              "principalId",
              "authorizationMode"
            ],
            "properties": {
              "participantId": {},
              "side": {},
              "partnerId": {},
              "principalId": {},
              "agentId": {},
              "authorizationMode": {}
            }
          }
        },
        "confirmations": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/CaseDraftConfirmationResource",
            "type": "object",
            "additionalProperties": false,
            "required": [
              "participantId",
              "side",
              "authorizationMode",
              "required",
              "status",
              "confirmationStatement"
            ],
            "properties": {
              "participantId": {},
              "side": {},
              "partnerId": {},
              "authorizationMode": {},
              "required": {},
              "status": {},
              "confirmationStatement": {}
            }
          }
        },
        "evaluation": {
          "$ref": "#/components/schemas/CaseDraftEvaluationDefinition",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "schemaVersion",
            "externalEvaluationId",
            "evaluationDigest",
            "question",
            "allowedOutcomes",
            "evidencePolicy",
            "reviewPolicy"
          ],
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "narrow-evaluation-v2"
            },
            "externalEvaluationId": {
              "type": "string"
            },
            "evaluationDigest": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "question": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "text",
                "criteria"
              ],
              "properties": {}
            },
            "allowedOutcomes": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/NarrowEvaluationOutcome"
              }
            },
            "evidencePolicy": {
              "$ref": "#/components/schemas/NarrowEvaluationEvidencePolicy"
            },
            "reviewPolicy": {
              "$ref": "#/components/schemas/NarrowEvaluationReviewPolicy"
            }
          }
        }
      }
    },
    "requestId": {
      "type": "string"
    }
  }
}

default

RFC 9457 style problem response.

application/problem+json

{
  "$ref": "#/components/schemas/Problem",
  "type": "object",
  "required": [
    "type",
    "title",
    "status",
    "code",
    "detail",
    "requestId"
  ],
  "properties": {
    "type": {
      "type": "string",
      "format": "uri"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer"
    },
    "code": {
      "type": "string"
    },
    "detail": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    }
  }
}

Example response

Successful response

{
  "data": {
    "schemaVersion": "confirmed-filing-v2",
    "caseId": "case_test_123",
    "externalCaseId": "marketplace_case_123",
    "status": "status_test",
    "rules": {
      "version": "version_test",
      "hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "createdAt": "2026-08-09T12:00:00.000Z",
    "headless": {
      "respondentHandoffPath": "respondentHandoffPath_test",
      "answerPath": "answerPath_test",
      "capabilityDelivery": "show_once_not_replayed"
    },
    "caseMode": "proceeding",
    "intakeMode": "claimant_initiated",
    "confirmationPolicy": {
      "mode": "initiator_only"
    },
    "procedure": {
      "schemaVersion": "case-procedure-plan-v2",
      "profile": "standard",
      "answerRequired": false,
      "evidenceRounds": 1,
      "rebuttalRounds": 1,
      "filingsPerSidePerStage": 1,
      "recordConfirmationRequired": true
    },
    "participants": [
      {
        "participantId": "participant_test_123",
        "side": "claimant",
        "principalId": "principal_test_123",
        "authorizationMode": "partner_credential"
      }
    ]
  },
  "requestId": "requestId_test"
}

Usage notes

Responses reflect the current authoritative resource state.
Send a unique Idempotency-Key. An exact retry returns the stored result; reusing the key with a different request fails.
The request is accepted only when its credential, authority, case state, and resource preconditions are satisfied.

Likely next action: Read the opened case or remaining confirmations →

Use https://peoplescourt.ai with the test credential issued for your integration.

cURL

curl --request POST \
  --url 'https://peoplescourt.ai/api/v2/case-drafts/draft_test_123/confirmations' \
  --header 'Authorization: Bearer pk_test_replace_me' \
  --header 'Idempotency-Key: idem_test_12345678' \
  --header 'Content-Type: application/json' \
  --data '{
  "participantId": "participant_test_123",
  "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "confirmationStatement": "COPY_EXACT_SERVER_CONFIRMATION_STATEMENT",
  "actorId": "agent_test_123",
  "principalId": "principal_test_123",
  "confirmationMethod": "protocol_act",
  "confirmationReference": "partner_reference_123"
}'

TypeScript / fetch

const response = await fetch("https://peoplescourt.ai/api/v2/case-drafts/draft_test_123/confirmations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer pk_test_replace_me",
    "Idempotency-Key": "idem_test_12345678",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "participantId": "participant_test_123",
    "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "confirmationStatement": "COPY_EXACT_SERVER_CONFIRMATION_STATEMENT",
    "actorId": "agent_test_123",
    "principalId": "principal_test_123",
    "confirmationMethod": "protocol_act",
    "confirmationReference": "partner_reference_123"
  }),
});
if (!response.ok) throw await response.json();
const result = await response.json();

Python

import requests

response = requests.post(
    "https://peoplescourt.ai/api/v2/case-drafts/draft_test_123/confirmations",
    headers={
      "Authorization": "Bearer pk_test_replace_me",
      "Idempotency-Key": "idem_test_12345678",
      "Content-Type": "application/json"
    },
    json={
      "participantId": "participant_test_123",
      "draftDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "confirmationStatement": "COPY_EXACT_SERVER_CONFIRMATION_STATEMENT",
      "actorId": "agent_test_123",
      "principalId": "principal_test_123",
      "confirmationMethod": "protocol_act",
      "confirmationReference": "partner_reference_123"
    },
    timeout=30,
)
response.raise_for_status()
result = response.json()