Substy Developers
Media and vault

Initialize vault upload

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.

POST/v1/agencies/{agencyId}/creators/{creatorId}/vault/uploads

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.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string
Length1 <= length

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 POST "https://example.com/v1/agencies/string/creators/string/vault/uploads" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "filename": "string",    "size": 1,    "contentType": "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"  }}

Check agency banned words POST

Check supplied text against the agency's active banned-word rules. This validates content without sending or publishing it.

Upload vault part PUT

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.