Substy Developers
Media and vault

Update vault media

Update a creator vault media record using the supplied media metadata.

PATCH/v1/agencies/{agencyId}/creators/{creatorId}/vault/media/{mediaId}

Update a creator vault media record using the supplied media metadata.

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 PATCH "https://example.com/v1/agencies/string/creators/string/vault/media/string" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "media": {      "price": 0,      "type": "PHOTO",      "files": {        "preview": "string",        "thumb": "string",        "full": "string"      },      "createdAt": "string"    }  }'
{  "data": {    "id": "string",    "price": 0,    "type": "PHOTO",    "isSoloPpv": true,    "basePrice": 0,    "maxPrice": 0,    "tags": [      "string"    ],    "lists": [      {        "id": "string",        "name": "string"      }    ],    "files": {      "preview": "string",      "thumb": "string",      "full": "string"    },    "creatorTags": [      "string"    ],    "createdAt": "string",    "context": null,    "contextStatus": null,    "duration": null,    "hasScripts": null,    "alreadySent": null,    "alreadyOpened": null,    "position": null,    "isPreview": null,    "messageTemplates": null,    "scriptNames": null,    "messageTemplateNames": null,    "isReady": null,    "isUploading": null,    "purchasedByFan": null,    "contentAccess": {      "tool": "media__read",      "arguments": {        "agencyId": "string",        "input": {          "creatorId": "string",          "mediaId": "string",          "variant": "full"        }      },      "variants": [        "full"      ],      "note": "string"    }  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Get vault media GET

Read one creator vault media record, including its stored metadata and AI context. Use read_media_bytes when file contents are needed.

List vault media GET

Search and list creator vault media by text, media type, folder or script usage. Pass fanId for chat-specific mediaStatus (paid, free, unpaid, not_sent); on OnlyFans, Fanvue and MYM the first read queues a background scan of the sent-media history, and until it completes media without a stored send are unknown (null), never not_sent; poll get_fan_media_history_status. Filter statuses to ["not_sent"] to exclude previously sent media. Follow nextCursor while hasMore is true, including empty filtered pages.