api.traveldele.com · build 1 · phases 0–2

Traveldele Platform API

Product interfaces decide how an experience looks. The Platform API decides what is true.

database ok67 endpoints0 events pending deliveryopenapi.yaml ↗
  • POST
    /v1/identity/register

    Register a Traveldele userpublic

  • POST
    /v1/identity/login

    Email + password sign-inpublic

  • POST
    /v1/identity/refresh

    Exchange a refresh tokenpublic

  • POST
    /v1/identity/logout

    Revoke all sessions for the caller

  • GET
    /v1/identity/me

    Caller's canonical identity

  • PATCH
    /v1/identity/me

    Update profile fields

  • POST
    /v1/identity/me/mfa/enable

    MFA enrolment (use Supabase Auth MFA factors; required for super admin + finance)

  • POST
    /v1/identity/workspace/switch

    Select org/location; returns role, capabilities, permissions

  • GET
    /v1/identity/workspace

    Current workspace context

  • GET
    /v1/identity/workspaces

    All partner workspaces for the caller

  • GET
    /v1/partner/organizations

    Organizations the caller belongs to

  • POST
    /v1/partner/organizations

    Create an organization with its first location

  • GET
    /v1/partner/locations/:id

    Location detail

  • GET
    /v1/partner/locations/:id/capabilities

    Location capabilities

  • GET
    /v1/partner/locations/:id/staff

    Staff and pending invitations

  • POST
    /v1/partner/locations/:id/staff/invite

    Invite or add a staff member

  • POST
    /v1/partner/claim-tokens

    Create a claim token (platform operations)

  • GET
    /v1/partner/claim/:token

    Look up a claim token

  • POST
    /v1/partner/claim/:token/activate

    Claim a location as owner

  • POST
    /v1/partner/scans

    Resolve a Passport QR into a Visit Session + full context

  • GET
    /v1/partner/visit-sessions/:id

    Visit session detail

  • POST
    /v1/partner/visit-sessions/:id/actions

    CLOSE | CHECK_OUT | VOID | ADJUST

  • GET
    /v1/partner/users/:relationship_id

    Guest relationship detail

  • GET
    /v1/partner/visits

    Visits at a location

  • GET
    /v1/partner/catalog

    Catalog items

  • POST
    /v1/partner/catalog

    Create catalog item

  • PATCH
    /v1/partner/catalog/:id

    Update / publish catalog item

  • DELETE
    /v1/partner/catalog/:id

    Archive catalog item

  • GET
    /v1/partner/departures

    Departures (guides see their own)

  • POST
    /v1/partner/departures

    Schedule a departure

  • GET
    /v1/partner/departures/:id

    Departure detail

  • PATCH
    /v1/partner/departures/:id/status

    BOARDING | IN_PROGRESS | COMPLETED | CANCELLED

  • GET
    /v1/partner/departures/:id/roster

    Registrants with visit_session_id

  • GET
    /v1/partner/offers

    Offers at a location

  • POST
    /v1/partner/offers

    Create offer

  • POST
    /v1/partner/offers/:id/redeem

    Redeem during a visit { visit_session_id, user_id }

  • GET
    /v1/partner/offers/:id/activity

    Claims and redemptions

  • GET
    /v1/traveler/offers

    Active offers for travelers

  • POST
    /v1/traveler/offers/:id/claim

    Claim an offer { location_id }

  • GET
    /v1/traveler/bookings

    Caller's booking requests

  • POST
    /v1/traveler/bookings

    Create a booking request

  • DELETE
    /v1/traveler/bookings/:id

    Cancel own booking

  • GET
    /v1/partner/bookings

    Bookings at a location

  • POST
    /v1/partner/bookings/:id/confirm

    Confirm (optional immutable quote)

  • POST
    /v1/partner/bookings/:id/decline

    Decline a request

  • POST
    /v1/partner/bookings/:id/cancel

    Cancel a booking

  • GET
    /v1/partner/stay-space/posts

    Stay Space posts at a location

  • POST
    /v1/partner/stay-space/posts

    Post announcement | event | guest_deal | guide_pick

  • POST
    /v1/partner/broadcasts

    Broadcasts (phase 4)stub

  • GET
    /v1/traveler/stay-space

    Current stay (if active)

  • GET
    /v1/traveler/stay-space/posts

    Posts from active stays

  • GET
    /v1/traveler/passport

    Passport profile + stats

  • POST
    /v1/traveler/passport/qr

    Issue a fresh QR token (raw value returned once)

  • GET
    /v1/creator/profile

    Caller's creator storefront profile

  • PUT
    /v1/creator/profile

    Create or update the creator storefront profile

  • POST
    /v1/partner/import/start

    Start AI import from pdf (URL) | url | text; drafts go to review

  • GET
    /v1/partner/import/:job_id

    Import job status

  • GET
    /v1/partner/import/:job_id/results

    Draft catalog items for review

  • POST
    /v1/partner/import/:job_id/accept

    Accept drafts into the catalog

  • POST
    /v1/partner/compose/parse

    Deferredstub

  • GET
    /v1/admin/organizations

    All organizations + unclaimed locations

  • PATCH
    /v1/admin/organizations/:id/status

    Change organization status

  • POST
    /v1/admin/locations

    Create a (possibly unclaimed) location

  • POST
    /v1/admin/locations/:id/capabilities

    Grant capability

  • DELETE
    /v1/admin/locations/:id/capabilities/:cap

    Revoke capability

  • GET
    /v1/admin/audit-log

    Immutable audit events

  • POST
    /v1/manage/booking-sync

    Manage reservation sync (stub; processing deferred)stub