POSTpartial

File a challenge under the case-pinned historical AI-configuration procedure

Only a case-bound party or authorized representative may file. Current Rules reject this historical procedure. The response retains the hosted ok/data or ok/error/code envelope. Administrative resolution remains an internal restricted act.

/api/cases/{id}/ai-configuration-challengesfileHistoricalAiConfigurationChallengeCanonical

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

AccountOAuth

Account tokens authorize only their approving account and case scope. S256 PKCE is mandatory on the code flow. Explicit reacceptance is required after Rules/disclosure changes.

Parameters

Name	Location	Requirement	Schema
`id`	path	Required	`{"type":"string"}`

Request body

Required request body.

application/json

{
  "type": "object",
  "required": [
    "expectedRevision",
    "concern"
  ],
  "properties": {
    "expectedRevision": {
      "type": "integer"
    },
    "concern": {
      "type": "string",
      "enum": [
        "provider_is_party",
        "operator_is_party",
        "developer_is_party",
        "controlling_affiliate_is_party",
        "direct_material_economic_interest",
        "material_subject_integrity_risk",
        "data_incompatibility",
        "integrity_defect",
        "configuration_unavailable",
        "generic_ai"
      ]
    },
    "detail": {
      "type": "string"
    }
  }
}

Responses

201

Challenge stored under the pinned historical procedure.

application/json

{
  "type": "object",
  "properties": {
    "ok": {
      "const": true
    },
    "data": {
      "type": "object",
      "properties": {
        "status": {
          "const": "committed"
        },
        "dispute": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "revision": {
              "type": "integer"
            },
            "aiConfigurationChallenges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "concern": {
                    "type": "string"
                  },
                  "detail": {
                    "type": "string"
                  },
                  "filedBySide": {
                    "type": "string",
                    "enum": [
                      "claimant",
                      "respondent"
                    ]
                  },
                  "filedAt": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "statusBeforeHold": {
                    "type": "string"
                  },
                  "suspendedRunIds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "resolution": {
                    "type": "object",
                    "properties": {
                      "at": {
                        "type": "string"
                      },
                      "actorLabel": {
                        "type": "string"
                      },
                      "reasons": {
                        "type": "string"
                      },
                      "replacementSelected": {
                        "type": "boolean"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "challenge": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "concern": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            },
            "filedBySide": {
              "type": "string",
              "enum": [
                "claimant",
                "respondent"
              ]
            },
            "filedAt": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "statusBeforeHold": {
              "type": "string"
            },
            "suspendedRunIds": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "resolution": {
              "type": "object",
              "properties": {
                "at": {
                  "type": "string"
                },
                "actorLabel": {
                  "type": "string"
                },
                "reasons": {
                  "type": "string"
                },
                "replacementSelected": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "required": [
        "status",
        "dispute",
        "challenge"
      ]
    }
  },
  "required": [
    "ok",
    "data"
  ]
}

default

Unchanged hosted error envelope; authority, revision and historical Rules restrictions apply.

application/json

{
  "type": "object",
  "properties": {
    "ok": {
      "const": false
    },
    "error": {
      "type": "string"
    },
    "code": {
      "type": "string"
    }
  }
}

Example response

Successful response

{
  "ok": true,
  "data": {
    "status": "committed",
    "dispute": {},
    "challenge": {}
  }
}

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.

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

cURL

curl --request POST \
  --url 'https://peoplescourt.ai/api/cases/id_test/ai-configuration-challenges' \
  --header 'Cookie: arb_session=COPY_ACCOUNT_SESSION' \
  --header 'Origin: https://peoplescourt.ai' \
  --header 'Content-Type: application/json' \
  --data '{
  "expectedRevision": 1,
  "concern": "provider_is_party"
}'

TypeScript / fetch

import type { ApiCanonicalFileHistoricalAiConfigurationChallengeCanonicalResponse, ApiCanonicalFileHistoricalAiConfigurationChallengeCanonicalInput } from "./sdk/typescript/src/index.ts";

const input: ApiCanonicalFileHistoricalAiConfigurationChallengeCanonicalInput = {
  "expectedRevision": 1,
  "concern": "provider_is_party"
};

const response = await fetch("https://peoplescourt.ai/api/cases/id_test/ai-configuration-challenges", {
  method: "POST",
  headers: {
    "Cookie": "arb_session=COPY_ACCOUNT_SESSION",
    "Origin": "https://peoplescourt.ai",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(input),
});
if (!response.ok) throw await response.json();
const result: ApiCanonicalFileHistoricalAiConfigurationChallengeCanonicalResponse = await response.json();

Python

import requests

response = requests.post(
    "https://peoplescourt.ai/api/cases/id_test/ai-configuration-challenges",
    headers={
      "Cookie": "arb_session=COPY_ACCOUNT_SESSION",
      "Origin": "https://peoplescourt.ai",
      "Content-Type": "application/json"
    },
    json={"expectedRevision": 1, "concern": "provider_is_party"},
    timeout=30,
)
response.raise_for_status()
result = response.json()