Create a episode exclusion request

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Path parameters

• versionIdstringrequired

Header parameters

• idempotency-keystringrequired
• Idempotency-Keystring

  Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Request body

• actionstringrequired
  Allowed values

  exclude

  restore
• datasetVersionItemIdsarray<string (uuid)>

  dataset_version_item ids (one selector required; validated in the service).

• sampleKeysarray<string>

  Alternative selector: version-unique sampleKeys.

• episodeIndexesarray<number>

  Alternative selector: episode indexes within the version.

• checkIdstring

  Exclusion attributed to a catalog checkId (validated in the service).

• notestring

  Optional free-form note recorded in the audit entry.

Responses

{
  "data": {
    "datasetVersionId": "string",
    "action": "exclude",
    "requestedCount": 0,
    "changedCount": 0,
    "reason": "string",
    "items": [
      {
        "datasetVersionItemId": "string",
        "sampleKey": "string",
        "episodeIndex": 0,
        "excludedFromTraining": false,
        "excludedReason": "string",
        "changed": false
      }
    ],
    "idempotentReuse": false
  }
}