End Contract

Ends a contract. The outcome depends on whether funded escrow is at stake:

• No funded milestones — the end executes immediately and returns 200 with status: "ended".
• Funded milestones exist — ending releases or refunds money, so the call returns 202 with a pending approval (type: "contract_end"). A signed-in human must open approval.approvalUrl and confirm before the contract ends. Approvals expire after ~72 hours. Track the outcome via GET /approvals/{id} or the approval.confirmed event on GET /updates.

The request has no body. Re-requesting while a pending approval exists returns the same approval (idempotent).

Requirements: payments:write scope + the public_api_payments_write feature + a claimed account (unclaimed accounts get 403 with details.reason: "account_claim_required" and a claimUrl). The contract must be yours and still active.

Request

contractIdstringpathrequired

The contract to end.

Response — 200 (ended directly)

okboolean

true.

contractIdstring

The ended contract’s ID.

statusstring

ended.

Response — 202 (human co-sign required)

approvalobject

The pending approval, in the same shape as GET /approvals/{id}: {id, type: "contract_end", status: "pending", contractId, milestoneId: null, jobId, proposalId: null, approvalUrl, expiresAt, resolvedAt, result, createdAt}.

messagestring

Explains that a signed-in human must confirm ending the contract in the OpenTrain app.

Errors

Status	code	Meaning
400	BAD_REQUEST	Missing contractId
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Missing payments:write scope, public_api_payments_write disabled, or account not claimed (details.reason: "account_claim_required", details.claimUrl)
404	NOT_FOUND	No such contract, or the contract is on another account
409	CONFLICT	Contract has already ended (details.reason: "contract_ended")

Request examples

curlCLIMCP: opentrain_end_contract

curl

curl -sS -X POST https://app.opentrain.ai/api/public/v1/contracts/<CONTRACT_ID>/end \
  -H "Authorization: Bearer $OT_API_TOKEN"

CLI

opentrain contracts end --contract-id <CONTRACT_ID> --json

MCP: opentrain_end_contract

{
  "contractId": "<CONTRACT_ID>"
}

Response examples

200 (ended directly)202 (co-sign required)

200 (ended directly)

{
  "ok": true,
  "contractId": "<CONTRACT_ID>",
  "status": "ended"
}

202 (co-sign required)

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "contract_end",
    "status": "pending",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": null,
    "jobId": "<JOB_ID>",
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": null,
    "result": null,
    "createdAt": "2026-06-12T10:00:00.000Z"
  },
  "message": "This contract has funded milestones, so a signed-in human must confirm ending it in the OpenTrain app."
}