Substy Developers
Media and vault

Get vault media by ids

Look up up to 100 vault media records by ID for one creator. Split larger ID sets into separate requests.

GET/v1/agencies/{agencyId}/creators/{creatorId}/vault/media-selection

Look up up to 100 vault media records by ID for one creator. Split larger ID sets into separate requests.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string

Query Parameters

ids*array<string>
Itemsitems <= 100

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/creators/string/vault/media-selection?ids=string" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "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,      "duration": null,      "hasScripts": null,      "alreadySent": null,      "alreadyOpened": null,      "position": null,      "isPreview": null,      "messageTemplates": null,      "scriptNames": null,      "messageTemplateNames": null,      "isReady": null,      "isUploading": null,      "contentAccess": {        "tool": "media__read",        "arguments": {          "agencyId": "string",          "input": {            "creatorId": "string",            "mediaId": "string",            "variant": "full"          }        },        "variants": [          "full"        ],        "note": "string"      }    }  ],  "meta": {    "requestId": "string"  }}

Delete vault media DELETE

Delete the selected media items from the creator's vault using their media IDs.

List vault folders GET

List the creator's media-vault folders with item counts and pagination. A null nextCursor indicates the last page.