{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/autodesk/json-schema/autodesk-transfer-bucket-ownership-payload-schema.json",
  "title": "TransferBucketOwnershipPayload",
  "description": "The request payload for the Transfer Bucket Ownership operation.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/autodesk-aps-oss-openapi.yml#/components/schemas/TransferBucketOwnershipPayload",
  "type": "object",
  "required": [
    "operation"
  ],
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "initiate",
        "complete",
        "cancel"
      ],
      "description": "The transfer operation to perform. Possible values:\n\n- ``initiate`` : Initiates a bucket ownership transfer by specifying the target application that will become the new owner. This operation can only be performed by the current bucket owner.\n- ``complete`` : Accepts and completes a pending bucket ownership transfer. This operation can only be performed by the target application specified when the transfer was initiated.\n- ``cancel`` : Cancels a pending bucket ownership transfer before it is completed. This operation can be performed by either the current bucket owner or the target application.\n"
    },
    "key": {
      "type": "string",
      "description": "The client ID of the application that will become the new bucket owner. ``key`` must be specified only when ``operation`` is set to ``initiate``. It must not be specified when ``operation`` is ``complete`` or ``cancel``.\n\n**Important:** The service does not validate ``key``. If you specify an invalid client ID, the request still returns HTTP status 200. After a successful ``initiate`` request, the bucket enters a transitional state even when ``key`` is invalid.\n"
    }
  }
}