Resolve media UUIDs for a creator chat message

curl -G https://api.fanvue.com/creators/creatorUserUuid/chats/userUuid/messages/messageUuid/media \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>" \
     -d mediaUuids=mediaUuids

{
  "results": {
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890": {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "messageUuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "mediaType": "image",
      "created_at": "2024-01-15T00:00:00.000Z",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "ownerUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
      "name": "Beach Sunset",
      "variants": [
        {
          "variantType": "main",
          "displayPosition": 0,
          "width": 1920,
          "height": 1440,
          "lengthMs": null,
          "url": "https://media.fanvue.com/main/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        }
      ]
    },
    "00000000-0000-0000-0000-000000000000": null
  },
  "errors": [
    {
      "mediaUuid": "00000000-0000-0000-0000-000000000000",
      "code": "NOT_IN_MESSAGE",
      "message": "Media UUID is not attached to this message"
    }
  ]
}

Resolves means: for each requested mediaUuid, lookup that media only within the specified messageUuid in this creator conversation, then return its chat media payload (metadata + signed variant URLs) or a per-item error.

Scopes required: read:creator, read:chat

The mediaUuids query parameter is required and accepts up to 20 UUIDs.

Resolves means: for each requested `mediaUuid`, lookup that media only within the specified `messageUuid` in this creator conversation, then return its chat media payload (metadata + signed variant URLs) or a per-item error. <Info>Scopes required: `read:creator`, `read:chat`</Info> <Note>The `mediaUuids` query parameter is required and accepts up to 20 UUIDs.</Note>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

userUuidstringRequiredformat: "uuid"

messageUuidstringRequiredformat: "uuid"

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

Query parameters

mediaUuidsstringRequired

Comma-separated list of media UUIDs to resolve (required, max 20)

variantsstringOptional

Optional comma-separated list of variant types to include

Response

Resolved media payload map

resultsmap from strings to objects

Map media UUID -> media payload (null when unavailable)

errorslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

429

Too Many Requests Error