TEASEDocs
API ReferenceVault

Add a manual tag

Adds a normalized manual tag to a vault media item. Namespaced facets (cat:* / mood:* / len:* / kink:*) and plain tags are allowed. Idempotent: re-adding an existing tag is a no-op. Requires a write-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Path Parameters

media_id*string

Vault media id.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

POST
/api/admin/content/{media_id}/tags
curl -X POST "https://example.com/api/admin/content/string/tags" \  -H "Content-Type: application/json" \  -d '{    "tag": "mood:playful"  }'
{  "media_id": "501",  "tag": "mood:playful",  "source": "manual",  "created": true}
{  "detail": "empty tag"}
{  "detail": "Not authenticated"}
{  "detail": {    "code": "engine_not_connected",    "message": "Connect your engine to access this data."  }}

Per-content PPV send analytics

For one vault media, aggregates your PPV sends joined to purchase status: sent, opened, purchased, revenue, and the deduped list of buyers. Renders zeros honestly when there are no sends. Requires a read-scoped key.

Remove a manual tag

Removes a manual tag (normalized match) from a vault media item. Only manual tags are deletable; a non-manual or absent tag returns 404. Requires a write-scoped key.