API DocsAPI Docs / POST /api/v1/media

Available purpose values:

Sensitive media. A media row with a purpose is never publicly downloadable: GET /api/v1/media/{media}/{filename} applies per-purpose access control to it, and it is excluded from the owning record's public media array. Uploading a license also points the owning record's *_license_image at the new file, deletes the superseded document, and resets *_license_approved to null (pending), because a new document has to be reviewed again: this applies to both trainer_license (on the user) and gym_license (on the gym). Omitting purpose (or sending null) uploads ordinary, publicly readable gallery media.

Available attachable_type values:

• championship
• gym
• gym_equipment
• post
• user
• education
• gym_buffet_item
• training_service
• tracker_meal
• tracker_progress_photo

tracker_progress_photo is share-gated, not public. Ordinary media without a purpose is readable by anyone who may read the record it hangs off, and for most types that is a wide audience. A progress photo's audience is exactly the athlete plus any viewer holding a tracker share with include_progress_photo = true whose window covers the entry's tracked_at: the same rule that governs the entry itself, applied to the file. See the progress photo resource.

Request Example (multipart/form-data)

Response

201 Created

Returns the created media resource.

Example

For a full schema, see Media Resource.

Error Responses