POSTpartial

Accept the exact fast-track upgrade offer

Native account-session operation using the internal case ID. Acceptance and decline require a current signed-in party or a representative authorized to consent to arbitration. OAuth and partner bearer credentials cannot authorize this operation. Both parties accept the exact offered Record, target terms and fee delta. No MCP operation is exposed. Decline, expiry and integrity termination follow the pinned refund policy. Repeated acceptance cannot create a second fee.

/api/cases/{id}/fast-track-upgrade/acceptacceptNativeFastTrackUpgrade

Authentication and authority

Use one listed account-session, scoped OAuth, or partner credential alternative. Account tokens retain the approving account’s authority. Cookie-authenticated writes require same-origin authorization. Alternatives are OR; schemes in one alternative are AND.

CanonicalSession

Parameters

NameLocationRequirementSchema
id

Internal case ID, not a partner public case ID.

pathRequired{"type":"string"}

Request body

Required request body.

application/json

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "offerId",
    "recordHash",
    "termsHash",
    "deltaUsd",
    "accepted"
  ],
  "properties": {
    "offerId": {
      "type": "string"
    },
    "recordHash": {
      "type": "string"
    },
    "termsHash": {
      "type": "string",
      "description": "Exact targetTerms.termsHash."
    },
    "deltaUsd": {
      "type": "number",
      "minimum": 0
    },
    "accepted": {
      "type": "boolean",
      "const": true
    },
    "appealWaiverAccepted": {
      "type": "boolean",
      "description": "Separately acknowledges the internal appeal waiver. Must be true when targetTerms.appealWaived is true; otherwise omit or supply false. Strings and other values are rejected."
    }
  }
}

Responses

200

Current party-visible offer

application/json

{
  "type": "object",
  "required": [
    "ok",
    "data"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "data": {
      "$ref": "#/components/schemas/FastTrackUpgradeOffer",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "offerId",
        "state",
        "recordHash",
        "sourceTermsHash",
        "targetTerms",
        "deltaUsd",
        "feeMethod",
        "expiresAt",
        "acceptedBy",
        "eligible"
      ],
      "properties": {
        "offerId": {
          "type": "string"
        },
        "state": {
          "type": "string",
          "enum": [
            "offered",
            "accepted",
            "payment_pending",
            "resumed",
            "declined",
            "expired"
          ]
        },
        "recordHash": {
          "type": "string"
        },
        "sourceTermsHash": {
          "type": "string"
        },
        "targetTerms": {
          "$ref": "#/components/schemas/CaseProcedureTerms",
          "type": "object",
          "additionalProperties": false,
          "required": [
            "schemaVersion",
            "track",
            "appealWaived",
            "waiverDisclosureVersion",
            "waiverDisclosureHash",
            "rulesVersion",
            "rulesHash",
            "behaviorVersion",
            "disclosureVersion",
            "disclosureHash",
            "feePolicyVersion",
            "termsHash"
          ],
          "properties": {
            "schemaVersion": {
              "type": "string",
              "const": "case-procedure-v1"
            },
            "track": {
              "type": "string",
              "enum": [
                "ai_fast",
                "ai_standard",
                "ai_assisted_human"
              ]
            },
            "appealWaived": {
              "type": "boolean"
            },
            "waiverDisclosureVersion": {
              "type": "string",
              "minLength": 1
            },
            "waiverDisclosureHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "rulesVersion": {
              "type": "string",
              "minLength": 1
            },
            "rulesHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "behaviorVersion": {
              "type": "string",
              "minLength": 1
            },
            "disclosureVersion": {
              "type": "string",
              "minLength": 1
            },
            "disclosureHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            "feePolicyVersion": {
              "type": "string",
              "minLength": 1
            },
            "termsHash": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "deltaUsd": {
          "type": "number",
          "minimum": 0
        },
        "feeMethod": {
          "type": "string",
          "const": "fiat_card"
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "paymentDeadlineAt": {
          "type": "string",
          "format": "date-time"
        },
        "acceptedBy": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "claimant",
              "respondent"
            ]
          }
        },
        "eligible": {
          "type": "boolean"
        },
        "feeRecordId": {
          "type": "string"
        },
        "refundStatus": {
          "type": "string",
          "enum": [
            "pending",
            "complete",
            "reconciliation_required"
          ]
        }
      }
    }
  }
}
default

Operation refused or unavailable; no acceptance is recorded.

application/json

{
  "type": "object",
  "required": [
    "ok",
    "error"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "const": false
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    }
  }
}

Example response

Successful response

{
  "ok": true,
  "data": {
    "offerId": "offerId_test",
    "state": "offered",
    "recordHash": "recordHash_test",
    "sourceTermsHash": "sourceTermsHash_test",
    "targetTerms": {
      "schemaVersion": "case-procedure-v1",
      "track": "ai_fast",
      "appealWaived": false,
      "waiverDisclosureVersion": "waiverDisclosureVersion_test",
      "waiverDisclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "rulesVersion": "rulesVersion_test",
      "rulesHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "behaviorVersion": "behaviorVersion_test",
      "disclosureVersion": "disclosureVersion_test",
      "disclosureHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "feePolicyVersion": "2026-08-test",
      "termsHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "deltaUsd": 0,
    "feeMethod": "fiat_card",
    "expiresAt": "2026-08-09T12:00:00.000Z",
    "acceptedBy": [
      "claimant"
    ],
    "eligible": false
  }
}

Errors

Read the response status and stable error code. See errors and rate limits for recovery. Refresh the resource before resolving a state or digest conflict.

Idempotency and retries

  • For throttling, honor Retry-After when present. Back off on retryable server failures.
  • The request is accepted only when its credential, authority, case state, and resource preconditions are satisfied.