Media

Serve media (JSON for unencrypted, binary for encrypted)

  • If the media is encrypted (SSE-C), the server returns the binary content with server-side decryption and checksum verification.
  • If not encrypted, returns the Media object (with the S3 URL).
get/media/serve/{id}

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/media/serve/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

OK

idstring uuid nullable
urlstring nullable
media_typestring nullable

MIME type (e.g. application/pdf, image/jpeg)

file_sizeinteger nullable
security_level'STANDARD' | 'SENSITIVE' | 'CRITICAL'

Security/encryption level. CRITICAL and SENSITIVE may trigger SSE-C encrypted storage; STANDARD is unencrypted.

encryption_key_idstring nullable

SSE-C key identifier if the media is encrypted (secure mode)

checksumstring nullable

SHA-256 of the source content for integrity verification

tagsstring[] nullable

Tags normalized to lowercase; max 32 tags; each tag <= 64 chars, [a-z0-9_-]

rolesMediaRole[] nullable

Roles associated with this media for different entities

created_atstring date-time nullable
updated_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.