Endpoints

The Media Agency API exposes 13 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.

public-api

Method	Path	Page
POST	/api/v1/listings	Create a new listing.
GET	/api/v1/listings	List listings (paginated, agency-scoped, newest-updated first).
GET	/api/v1/listings/{listing_number}	Read a single listing by its canonical listing_number.
POST	/api/v1/listings/{listing_number}/cancel	Cancel a listing (no-fee window only).
GET	/api/v1/listings/{listing_number}/orders	List orders and payments linked to a listing.
PATCH	/api/v1/listings/{listing_number}/sections/floorplan	Set, replace, or append to the floorplan section.
PATCH	/api/v1/listings/{listing_number}/sections/matterport	Set or remove the matterport URL for a listing.
PATCH	/api/v1/listings/{listing_number}/status	Update listing status.
POST	/api/v1/media/upload	Request a presigned URL for a media upload (dual-authenticated).
GET	/api/v1/scheduling/availability	Read open shoot slots over a date range.
GET	/api/v1/users	List users in the caller's agency hierarchy.
GET	/api/v1/users/{user_id}	Read a single user in the caller's agency hierarchy.
GET	/api/v1/webhooks/events	Live catalog of all webhook events the platform emits.

Request conventions

• Base URL: https://valara.cloud/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.