API

Kumir developers

Native iOS/Android and partner integrations use versioned /api/v1. The machine-readable contract is OpenAPI 3.1 at GET /api/v1/openapi. Do not invent Stripe, APNs, FCM, or OAuth keys — missing providers return 501 or log-only, never a fake success.

Auth: POST /api/v1/auth/login returns an HS256 access token (1 hour) and a rotating refresh token (30 days). Send Authorization: Bearer … and X-Fameo-Channel: ios|android. Health probes /api/v1/health and /ready stay unauthenticated.

studio

GET /api/v1/studio/analytics
Studio analytics cards (optional q) · Talent
GET /api/v1/studio/analytics/topics
Studio analytics policy topics (optional q) · Public
GET /api/v1/studio/analytics/topics/{slug}
Studio analytics policy topic by slug · Public
GET /api/v1/studio/availability/topics
Studio Instant & Live policy topics (optional q) · Public
GET /api/v1/studio/availability/topics/{slug}
Studio Instant & Live policy topic by slug · Public
GET /api/v1/studio/connect
GET studio · connect · Talent
POST /api/v1/studio/connect
POST studio · connect · Talent
GET /api/v1/studio/decline-reasons
GET studio · decline-reasons · Talent
GET /api/v1/studio/earnings
Talent wallet + history (optional q) · Talent
GET /api/v1/studio/earnings/topics
Studio earnings policy topics (optional q) · Public
GET /api/v1/studio/earnings/topics/{slug}
Studio earnings policy topic by slug · Public
POST /api/v1/studio/feed
POST studio · feed · Talent
GET /api/v1/studio/feed/topics
Studio follower-feed policy topics (optional q) · Public
GET /api/v1/studio/feed/topics/{slug}
Studio follower-feed policy topic by slug · Public
POST /api/v1/studio/instant
POST studio · instant · Talent
POST /api/v1/studio/intro
POST studio · intro · Talent
DELETE /api/v1/studio/live-slots
DELETE studio · live-slots · Talent
GET /api/v1/studio/live-slots
Studio live slots (optional q) · Talent
POST /api/v1/studio/live-slots
POST studio · live-slots · Talent
GET /api/v1/studio/merch
Studio merch drops (optional q) · Talent
POST /api/v1/studio/merch
Publish a talent merch drop · Talent
PATCH /api/v1/studio/merch/{publicId}
Show or hide a studio merch drop · Talent
GET /api/v1/studio/merch/topics
Studio merch store policy topics (optional q) · Public
GET /api/v1/studio/merch/topics/{slug}
Studio merch store policy topic by slug · Public
GET /api/v1/studio/notifications/topics
Studio notification policy topics (optional q) · Public
GET /api/v1/studio/notifications/topics/{slug}
Studio notification policy topic by slug · Public
POST /api/v1/studio/payouts
Request a transfer (FIFO, KYC/Connect gated) · Talent
POST /api/v1/studio/photo
POST studio · photo · Talent
GET /api/v1/studio/profile-videos
GET studio · profile-videos · Talent
POST /api/v1/studio/profile-videos
POST studio · profile-videos · Talent
GET /api/v1/studio/requests
Studio request queue (optional q) · Talent
GET /api/v1/studio/requests/{publicId}
GET studio · requests · :publicId · Talent
POST /api/v1/studio/requests/{publicId}/accept-live
POST studio · requests · :publicId · accept-live · Talent
POST /api/v1/studio/requests/{publicId}/complete-live
POST studio · requests · :publicId · complete-live · Talent
POST /api/v1/studio/requests/{publicId}/decline
POST studio · requests · :publicId · decline · Talent
POST /api/v1/studio/requests/{publicId}/fulfill
Deliver a recorded Kumir (uploadId or multipart) · Talent
GET /api/v1/studio/requests/topics
Studio request-queue policy topics (optional q) · Public
GET /api/v1/studio/requests/topics/{slug}
Studio request-queue policy topic by slug · Public
GET /api/v1/studio/samples
Studio sample videos (optional q) · Talent
POST /api/v1/studio/samples
POST studio · samples · Talent
DELETE /api/v1/studio/samples/{id}
DELETE studio · samples · :id · Talent
GET /api/v1/studio/samples/topics
Studio sample-reel policy topics (optional q) · Public
GET /api/v1/studio/samples/topics/{slug}
Studio sample-reel policy topic by slug · Public
GET /api/v1/studio/settings
GET studio · settings · Talent
POST /api/v1/studio/settings
POST studio · settings · Talent
GET /api/v1/studio/settings/topics
Studio settings policy topics (optional q) · Public
GET /api/v1/studio/settings/topics/{slug}
Studio settings policy topic by slug · Public
GET /api/v1/studio/tax-docs
GET studio · tax-docs · Talent
GET /api/v1/studio/vip
Studio VIP members (optional q) · Talent
GET /api/v1/studio/vip/topics
Studio VIP membership policy topics (optional q) · Public
GET /api/v1/studio/vip/topics/{slug}
Studio VIP membership policy topic by slug · Public