Get a company media slot

GET

https://api.aventure.vc/v1/entities/:entityId/media/:mediaType

Returns the selected square or standard entity logo. Empty slots return 404.

Path parameters

entityIdstringRequiredformat: "uuid"

Canonical entity UUID

mediaTypeenumRequired

Media slot; entities serve logo.

Allowed values:

Query parameters

logoTypeenumOptional

Entity logo variant; defaults to square.

Allowed values:

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

cdnUrlstring

Resolved API CDN URL

mediaTypeenum

Target media domain

Allowed values:

pathstring

Attached managed storage path; never an external image URL

firstUploadedAtdatetime or nullOptional

Earliest recorded write timestamp for this media asset slot from res_provenance_event (when this entity/person/news first received any image in this slot).

provenanceobject or nullOptional

Latest write source for this media asset slot from res_provenance_event. changedAt is the last-modified timestamp of the current attached file.

targetIdstring or nullOptional

Attached entity/person/news target id, when known

Errors

400

Bad Request Error

404

Not Found Error

406

Not Acceptable Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error