# FairePlace Media API

**Canonical:** https://apis.io/apis/faireplace-com/faireplace-com-media-api/  
**Provider:** FairePlace — https://apis.io/providers/faireplace-com/  
**Base URL:** https://api.faireplace.com/api  
**Documentation:** https://developers.faireplace.com/api

FairePlace Media API is one of 56 APIs that [FairePlace](https://apis.io/providers/faireplace-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Media. The published artifact set on APIs.io includes an OpenAPI specification.

Media management (photos, PDF documents)

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/media/upload/{entity_type}/{entity_id}` | Upload media and attach to entity |
| GET | `/media/{entity_type}/{entity_id}` | List media attached to an entity |
| GET | `/media/search` | Search media by tags (optionally scoped to an entity) |
| PUT | `/media/{id}/tags` | Replace media tags |
| PUT | `/media/{entity_type}/{entity_id}/{media_id}/role` | Assign a unique role to a media for an entity |
| DELETE | `/media/{entity_type}/{entity_id}/role/{role}` | Clear role assignment for an entity |
| GET | `/media/{entity_type}/{entity_id}/role/{role}` | Get media by role for an entity |
| GET | `/media/serve/{id}` | Serve media (JSON for unencrypted, binary for encrypted) |
| GET | `/media/download/{id}` | Download media as a binary stream |
| DELETE | `/media/{id}` | Delete media (S3 object and DB record) |
| GET | `/media/worker/{id}` | Serve media for workers (Base64 JSON) |
| POST | `/media/upload-signed/{media_id}` | Upload signed PDF from worker |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/faireplace-com/openapi/faireplace-com-media-api-openapi.yml

## Other FairePlace APIs (12)

- [FairePlace Amendment Documents API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-documents-api/)
- [FairePlace Amendment Duration Details API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-duration-details-api/)
- [FairePlace Amendment History API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-history-api/)
- [FairePlace Amendment Notifications API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-notifications-api/)
- [FairePlace Amendment Rent Details API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-rent-details-api/)
- [FairePlace Amendment Validations API](https://apis.io/apis/faireplace-com/faireplace-com-amendment-validations-api/)
- [FairePlace Charge Configuration API](https://apis.io/apis/faireplace-com/faireplace-com-charge-configuration-api/)
- [FairePlace Charges API](https://apis.io/apis/faireplace-com/faireplace-com-charges-api/)
- [FairePlace Condition Reports API](https://apis.io/apis/faireplace-com/faireplace-com-condition-reports-api/)
- [FairePlace Contacts API](https://apis.io/apis/faireplace-com/faireplace-com-contacts-api/)
- [FairePlace Countries API](https://apis.io/apis/faireplace-com/faireplace-com-countries-api/)
- [FairePlace Coupons API](https://apis.io/apis/faireplace-com/faireplace-com-coupons-api/)

## Tags

Media

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/faireplace-com/faireplace-com-media-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/faireplace-com/.