Endpoints
The Media Agency API exposes 33 public endpoints across listings, media, scheduling, webhooks, and users. Every row links to an auto-generated reference page with the request/response schema, parameter table, and runnable curl + Python examples.
Source of truth: https://valara.cloud/api/openapi.json
(legacy alias: https://dash.jacoballenmedia.com/api/openapi.json).
media
| Method | Path | Page |
|---|---|---|
GET | /api/v1/media/ | List Media Files |
GET | /api/v1/media/{file_id} | Get Media File Details |
DELETE | /api/v1/media/{file_id} | Delete Media File |
GET | /api/v1/media/{file_id}/download | Download Media File |
POST | /api/v1/media/archive | Create Media Archive |
GET | /api/v1/media/stats/summary | Get Media Statistics |
GET | /api/v1/media/tour/{tour_id}/files | Get Tour Media Files |
POST | /api/v1/media/upload | Upload media files |
GET | /api/v1/media/upload/{operation_id}/status | Get Media Upload Status |
team-management
| Method | Path | Page |
|---|---|---|
GET | /api/v1/users/team | List team assistants |
DELETE | /api/v1/users/team/{assistant_id} | Remove an assistant |
POST | /api/v1/users/team/invite | Invite an assistant |
users
| Method | Path | Page |
|---|---|---|
GET | /api/v1/users/ | Get Users Admin |
POST | /api/v1/users/ | Create new user (admin only) |
GET | /api/v1/users/{user_id} | Get User By Id Endpoint |
PATCH | /api/v1/users/{user_id} | Update user profile (partial) |
PUT | /api/v1/users/{user_id} | Update User |
DELETE | /api/v1/users/{user_id} | Delete User |
POST | /api/v1/users/{user_id}/activate | Toggle User Activation |
GET | /api/v1/users/{user_id}/can-edit | Check User Edit Permission |
POST | /api/v1/users/{user_id}/impersonate | Start Impersonation |
PUT | /api/v1/users/{user_id}/manager | Assign User Manager |
GET | /api/v1/users/{user_id}/preferences | Get user preferences |
PATCH | /api/v1/users/{user_id}/preferences | Update user preferences (partial) |
PUT | /api/v1/users/{user_id}/role | Update User Role Endpoint |
POST | /api/v1/users/{user_id}/send-password-reset | Send password reset email (admin only) |
PUT | /api/v1/users/{user_id}/status | Update User Status Endpoint |
GET | /api/v1/users/analytics | Get User Analytics |
POST | /api/v1/users/batch-can-edit | Batch Check Edit Permissions |
GET | /api/v1/users/order-form/by-slug/{slug} | Get order form owner by slug (public endpoint) |
GET | /api/v1/users/order-form/me | Get current user's order form info |
GET | /api/v1/users/order-form/me/manager | Get current user's manager order form info |
GET | /api/v1/users/order-form/photographers | List photographers/brokers for View As dropdown |
Request conventions
- Base URL:
https://valara.cloud/api/v1/(legacy alias:https://dash.jacoballenmedia.com/api/v1/). - Every mutation carries
X-Idempotency-Key(see authentication). - Every response carries
X-Rate-Limit-*headers (see rate limits). - Errors follow the canonical envelope documented on the error codes page.