API Changelog

2026-10-05

  • GET /api/f1/sync/bookings accepts include_all=true to also list bookings without an external_id
  • GET /api/f1/sync/filmers now reads include_all as a boolean, matching bookings: include_all=false returns only external filmers. Previously any non-blank value, including false, returned all filmers
  • POST /api/f1/sync/filmers (and the filmers batch) clarify that id should be provided for updates, but not for create. You can create with external_id - internal id is provided by FFF.

2026-09-09

  • Webhook payloads now include dropzone_uuid, identifying the dropzone the record belongs to

2026-08-08

  • DELETE /api/f1/sync/filmers/:id now returns 422 Unprocessable Content with an errors array when the filmer still has associated records. Previously it returned 204 No Content without deleting anything.

2026-06-18

  • Added video_entitlement and camera_requirement fields to the Finance Event entity (nested in Booking show responses)
  • Deprecated the Finance Event selfie, videographer, either_video and socials booleans. They are still returned (now derived from video_entitlement/camera_requirement) but clients should migrate to the new fields
  • Added video_entitlement and camera_requirement fields to the Product entity
  • Deprecated the Product selfie, videographer, either_video and socials booleans. They are still returned (now derived from video_entitlement/camera_requirement) but clients should migrate to the new fields

2026-06-05

  • Booking finance_events are now returned ordered by created_at ascending (ties broken by id). Previously the order was unspecified.

2026-04-17

  • Removed mobile field from Filmer entity

2026-03-29

  • Added optional datetime fields to Booking: jump_scheduled_at, jump_manifested_at, jump_performed_at (ISO 8601 with timezone)
  • album_status_raw can now return delaying_preview when a preview delay is configured on the dropzone

2026-03-17

  • Simplified Upgrade entity: removed kind and entitlement fields (photos, selfie, videographer, socials, raw_footage), added name

2026-03-03

  • Updated finance event type documentation to match actual event types correctly!

2026-01-27

  • Added Products endpoint (/api/f1/sync/products)
  • Added Upgrades endpoint (/api/f1/sync/upgrades)
  • Booking show now includes nested jump and finance_events data
  • Added new booking read-only fields: album_status_raw, product_id, created_at, updated_at
  • Added webhook support for real-time notifications (booking, jump, finance_event events)