Substy Developers
Media and vault

Upload vault part

Upload one file chunk using an uploadHandle from initialize_vault_upload. Supply a one-based partNumber, base64 bytes and their lowercase SHA-256 checksum. Each chunk must match chunkSize except the final remainder. Returns receivedParts; replacing a stored part with different bytes is rejected.

PUT/v1/agencies/{agencyId}/vault/uploads/{uploadHandle}/parts/{partNumber}

Upload one file chunk using an uploadHandle from initialize_vault_upload. Supply a one-based partNumber, base64 bytes and their lowercase SHA-256 checksum. Each chunk must match chunkSize except the final remainder. Returns receivedParts; replacing a stored part with different bytes is rejected.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
uploadHandle*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
partNumber*integer
Range1 <= value <= 10000

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/agencies/string/vault/uploads/497f6eca-6276-4993-bfeb-53cbbbba6f08/parts/1" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "sha256": "string",    "base64": "string"  }'
{  "data": {    "uploadHandle": "string",    "creatorId": "string",    "phase": "COMPLETED",    "chunkSize": 0,    "totalParts": 0,    "receivedParts": [      0    ],    "expiresAt": "string",    "result": null  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Initialize vault upload POST

Start uploading a file to a creator vault through MCP. Supply file metadata and total size in bytes; returns an uploadHandle, chunkSize, totalParts and expiry. Send chunks with upload_vault_part, then call complete_vault_upload. OnlyFans upload confirmation is enabled unless skipConfirmation is true.

Get vault upload status GET

Inspect an uploadHandle for its phase, expiry, receivedParts and processing result. Use receivedParts to identify missing chunks before completing the upload. COMPLETED means the provider accepted processing; inspect returned media identifiers for availability. Check UNKNOWN outcomes before repeating completion.