Substy Developers
Media and vault

Remove media from vault folder

Remove the selected media items from a vault folder. This changes folder membership rather than deleting the media.

DELETE/v1/agencies/{agencyId}/creators/{creatorId}/vault/media/{mediaId}/folder-memberships

Remove the selected media items from a vault folder. This changes folder membership rather than deleting the media.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

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

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 DELETE "https://example.com/v1/agencies/string/creators/string/vault/media/string/folder-memberships" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "folderIds": [      "string"    ]  }'
{  "data": {    "success": true  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Add media to vault folder POST

Add the selected vault media items to a creator's folder.

Initialize direct vault upload POST

Start a provider-URL upload requiring external HTTP PUT requests. Prefer initialize_vault_upload and upload_vault_part for transfers entirely through MCP. With putUrl, PUT the entire file; with putUrls, PUT ordered 5 MiB chunks. Retain key, uploadId and response ETags for complete_direct_vault_upload.