API DOCSv1

Partner API Reference

Programmatically create and manage events. Available to Reseller tier partners.

Authentication

All API requests require an API key. Include it in the x-api-key header:

x-api-key: flsh_...

Generate API keys from your partner dashboard. Navigate to Dashboard → Partner and look for the API Keys section.

Rate limit: 100 requests per minute per API key.

Endpoints

POST/api/events

Create a new event.

Request Body

{
  "name": "string (required)",
  "maxShotsPerGuest": 24,
  "privacy": "private | shared",
  "defaultLook": "classic"
}

Response

{
  "event": {
    "id": "uuid",
    "name": "string",
    "createdAt": "ISO date"
  }
}

Example — curl

curl -X POST https://flshbckz.com/api/events \
  -H "Content-Type: application/json" \
  -H "x-api-key: flsh_your_key_here" \
  -d '{"name":"Sarah & Tom Wedding","maxShotsPerGuest":24,"privacy":"private"}'

GET/api/events/:id

Get details for a specific event.

Response

{
  "event": {
    "id": "uuid",
    "name": "string",
    "maxShotsPerGuest": 24,
    "privacy": "private",
    "defaultLook": "classic",
    "guestTier": "free",
    "guestLimit": 5,
    "revealAt": "ISO date | null",
    "createdAt": "ISO date"
  }
}

Example — curl

curl https://flshbckz.com/api/events/{event_id} \
  -H "x-api-key: flsh_your_key_here"

PATCH/api/events/:id

Update an existing event.

Request Body

{
  "name": "string",
  "maxShotsPerGuest": 36,
  "privacy": "private | shared",
  "revealAt": "ISO date"
}

Example — curl

curl -X PATCH https://flshbckz.com/api/events/{event_id} \
  -H "Content-Type: application/json" \
  -H "x-api-key: flsh_your_key_here" \
  -d '{"name":"Updated Event Name","privacy":"shared"}'