{"openapi":"3.0.3","info":{"title":"8BALL Developer API","description":"Public REST API for the 8BALL Live developer platform.","version":"1.0.0"},"tags":[{"name":"OAuth","description":"OAuth 2.1 token endpoints"},{"name":"Users","description":"User profile endpoints"},{"name":"Channels","description":"Channel metadata endpoints"},{"name":"Categories","description":"Category endpoints"},{"name":"Livestreams","description":"Livestream endpoints"},{"name":"Chat","description":"Chat endpoints"},{"name":"Moderation","description":"Moderation endpoints"},{"name":"Events","description":"Webhook subscription endpoints"},{"name":"Health","description":"Service health checks"},{"name":"Internal","description":"Internal worker endpoints"}],"paths":{"/health/":{"get":{"summary":"Health check","tags":["Health"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["ok","service"],"properties":{"ok":{"const":true,"type":"boolean"},"service":{"const":"developer-api","type":"string"}}}}}}},"operationId":"getHealth"}},"/health/ready":{"get":{"summary":"Readiness check","tags":["Health"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["ready"],"properties":{"ready":{"const":true,"type":"boolean"}}}}}}},"operationId":"getHealthReady"}},"/oauth/token":{"post":{"summary":"Exchange an OAuth token","tags":["OAuth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/oauth.tokenBody"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/oauth.tokenBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/oauth.tokenBody"}}}},"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"$ref":"#/components/schemas/oauth.tokenResponse"}}}},"400":{"description":"Response for status 400","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"postOauthToken"}},"/oauth/revoke":{"post":{"summary":"Revoke an OAuth token","tags":["OAuth"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/oauth.revokeBody"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/oauth.revokeBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/oauth.revokeBody"}}}},"responses":{"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"postOauthRevoke"}},"/v1/users/me":{"get":{"summary":"Get current user","tags":["Users"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["bio","email","id","image_url","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"type":"string"}}}},"$id":"#/components/schemas/users.meResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1UsersMe"}},"/v1/channels/":{"get":{"summary":"List channels","tags":["Channels"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["bio","id","image_url","is_live","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_live":{"type":"boolean"},"username":{"type":"string"}}}}},"$id":"#/components/schemas/channels.listResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1Channels"}},"/v1/channels/{slug}":{"get":{"summary":"Get channel by slug","tags":["Channels"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["bio","id","image_url","is_live","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_live":{"type":"boolean"},"username":{"type":"string"}}}},"$id":"#/components/schemas/channels.channelResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1ChannelsBySlug"}},"/v1/categories/":{"get":{"summary":"List categories","tags":["Categories"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["description","featured","id","image_url","label","slug","sort_order"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"featured":{"type":"boolean"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"type":"string"},"slug":{"type":"string"},"sort_order":{"type":"number"}}}}},"$id":"#/components/schemas/categories.listResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1Categories"}},"/v1/categories/{id}":{"get":{"summary":"Get category","tags":["Categories"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["description","featured","id","image_url","label","slug","sort_order"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"featured":{"type":"boolean"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"type":"string"},"slug":{"type":"string"},"sort_order":{"type":"number"}}}},"$id":"#/components/schemas/categories.categoryResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1CategoriesById"}},"/v1/livestreams/":{"get":{"summary":"List livestreams","tags":["Livestreams"],"parameters":[{"name":"broadcaster_user_id","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["category","channel","id","thumbnail_url","title","updated_at"],"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"id":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]}}}}},"$id":"#/components/schemas/livestreams.listResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1Livestreams"}},"/v1/livestreams/{id}":{"get":{"summary":"Get livestream","tags":["Livestreams"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["category","channel","id","thumbnail_url","title","updated_at"],"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"id":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]}}}},"$id":"#/components/schemas/livestreams.livestreamResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1LivestreamsById"}},"/v1/chat/messages":{"get":{"summary":"List chat messages","tags":["Chat"],"parameters":[{"name":"room_name","in":"query","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["content","created_at","id","type","user_identity","user_name"],"properties":{"content":{"type":"string"},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"},"type":{"type":"string"},"user_identity":{"type":"string"},"user_name":{"type":"string"}}}}},"$id":"#/components/schemas/chat.messagesResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1ChatMessages"},"post":{"summary":"Send chat message","tags":["Chat"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/chat.sendMessageBody"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/chat.sendMessageBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/chat.sendMessageBody"}}}},"responses":{"201":{"description":"Response for status 201","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["content","created_at","id","room_name","type"],"properties":{"content":{"type":"string"},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"},"room_name":{"type":"string"},"type":{"type":"string"}}}},"$id":"#/components/schemas/chat.sendMessageResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"postV1ChatMessages"}},"/v1/chat/{messageId}":{"delete":{"summary":"Delete chat message","tags":["Chat"],"parameters":[{"name":"messageId","in":"path","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"deleteV1ChatByMessageId"}},"/v1/moderation/bans":{"get":{"summary":"List bans","tags":["Moderation"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["blocked_user","created_at","id"],"properties":{"blocked_user":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"}}}}},"$id":"#/components/schemas/moderation.bansListResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1ModerationBans"},"post":{"summary":"Create ban","tags":["Moderation"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/moderation.createBanBody"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/moderation.createBanBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/moderation.createBanBody"}}}},"responses":{"201":{"description":"Response for status 201","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["blocked_user","created_at","id"],"properties":{"blocked_user":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"}}}},"$id":"#/components/schemas/moderation.banResponse"}}}},"400":{"description":"Response for status 400","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"409":{"description":"Response for status 409","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"postV1ModerationBans"}},"/v1/events/subscriptions":{"get":{"summary":"List webhook subscriptions","tags":["Events"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["created_at","description","event_types","id","status","url"],"properties":{"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_types":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}}}}},"$id":"#/components/schemas/events.subscriptionsListResponse"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"getV1EventsSubscriptions"},"post":{"summary":"Create webhook subscription","tags":["Events"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/events.createSubscriptionBody"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/events.createSubscriptionBody"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/events.createSubscriptionBody"}}}},"responses":{"201":{"description":"Response for status 201","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["created_at","description","event_types","id","status","url"],"properties":{"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_types":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}}},{"type":"object","required":["signing_secret"],"properties":{"signing_secret":{"type":"string"}}}]}},"$id":"#/components/schemas/events.createSubscriptionResponse"}}}},"400":{"description":"Response for status 400","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"postV1EventsSubscriptions"}},"/v1/events/subscriptions/{id}":{"delete":{"summary":"Delete webhook subscription","tags":["Events"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"minLength":1,"type":"string"}}],"responses":{"401":{"description":"Response for status 401","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"403":{"description":"Response for status 403","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}},"404":{"description":"Response for status 404","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"}}}}},"operationId":"deleteV1EventsSubscriptionsById"}},"/cron/webhook-deliveries":{"get":{"summary":"Process webhook deliveries","tags":["Internal"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["delivered","failed","ok","processed","retried"],"properties":{"delivered":{"type":"number"},"failed":{"type":"number"},"ok":{"const":true,"type":"boolean"},"processed":{"type":"number"},"retried":{"type":"number"}},"additionalProperties":false}}}}},"operationId":"getCronWebhook-deliveries"},"post":{"summary":"Process webhook deliveries","tags":["Internal"],"responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"type":"object","required":["delivered","failed","ok","processed","retried"],"properties":{"delivered":{"type":"number"},"failed":{"type":"number"},"ok":{"const":true,"type":"boolean"},"processed":{"type":"number"},"retried":{"type":"number"}},"additionalProperties":false}}}}},"operationId":"postCronWebhook-deliveries"}},"/":{"get":{"summary":"Service metadata","tags":["Health"],"operationId":"getIndex"}}},"components":{"schemas":{"api.error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"$id":"#/components/schemas/api.error"},"oauth.revokeBody":{"type":"object","required":["token"],"properties":{"client_id":{"type":"string"},"client_secret":{"type":"string"},"token":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/oauth.revokeBody"},"oauth.tokenBody":{"type":"object","required":["grant_type"],"properties":{"client_id":{"type":"string"},"client_secret":{"type":"string"},"code":{"type":"string"},"code_verifier":{"type":"string"},"grant_type":{"type":"string"},"redirect_uri":{"type":"string"},"refresh_token":{"type":"string"},"scope":{"type":"string"}},"$id":"#/components/schemas/oauth.tokenBody"},"oauth.tokenResponse":{"type":"object","required":["access_token","expires_in","scope","token_type"],"properties":{"access_token":{"type":"string"},"expires_in":{"type":"number"},"refresh_token":{"type":"string"},"scope":{"type":"string"},"token_type":{"const":"Bearer","type":"string"}},"$id":"#/components/schemas/oauth.tokenResponse"},"users.meResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["bio","email","id","image_url","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"email":{"type":"string"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"username":{"type":"string"}}}},"$id":"#/components/schemas/users.meResponse"},"channels.channelResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["bio","id","image_url","is_live","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_live":{"type":"boolean"},"username":{"type":"string"}}}},"$id":"#/components/schemas/channels.channelResponse"},"channels.listResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["bio","id","image_url","is_live","username"],"properties":{"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_live":{"type":"boolean"},"username":{"type":"string"}}}}},"$id":"#/components/schemas/channels.listResponse"},"channels.slugParams":{"type":"object","required":["slug"],"properties":{"slug":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/channels.slugParams"},"categories.categoryResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["description","featured","id","image_url","label","slug","sort_order"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"featured":{"type":"boolean"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"type":"string"},"slug":{"type":"string"},"sort_order":{"type":"number"}}}},"$id":"#/components/schemas/categories.categoryResponse"},"categories.idParams":{"type":"object","required":["id"],"properties":{"id":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/categories.idParams"},"categories.listResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["description","featured","id","image_url","label","slug","sort_order"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"featured":{"type":"boolean"},"id":{"type":"string"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"label":{"type":"string"},"slug":{"type":"string"},"sort_order":{"type":"number"}}}}},"$id":"#/components/schemas/categories.listResponse"},"livestreams.idParams":{"type":"object","required":["id"],"properties":{"id":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/categories.idParams"},"livestreams.listQuery":{"type":"object","properties":{"broadcaster_user_id":{"type":"string"}},"$id":"#/components/schemas/livestreams.listQuery"},"livestreams.listResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["category","channel","id","thumbnail_url","title","updated_at"],"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"id":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]}}}}},"$id":"#/components/schemas/livestreams.listResponse"},"livestreams.livestreamResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["category","channel","id","thumbnail_url","title","updated_at"],"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}]},"channel":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"id":{"type":"string"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]}}}},"$id":"#/components/schemas/livestreams.livestreamResponse"},"chat.messageIdParams":{"type":"object","required":["messageId"],"properties":{"messageId":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/chat.messageIdParams"},"chat.messagesQuery":{"type":"object","required":["room_name"],"properties":{"room_name":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/chat.messagesQuery"},"chat.messagesResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["content","created_at","id","type","user_identity","user_name"],"properties":{"content":{"type":"string"},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"},"type":{"type":"string"},"user_identity":{"type":"string"},"user_name":{"type":"string"}}}}},"$id":"#/components/schemas/chat.messagesResponse"},"chat.sendMessageBody":{"type":"object","required":["content","room_name"],"properties":{"content":{"minLength":1,"type":"string"},"room_name":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/chat.sendMessageBody"},"chat.sendMessageResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["content","created_at","id","room_name","type"],"properties":{"content":{"type":"string"},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"},"room_name":{"type":"string"},"type":{"type":"string"}}}},"$id":"#/components/schemas/chat.sendMessageResponse"},"moderation.banResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["blocked_user","created_at","id"],"properties":{"blocked_user":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"}}}},"$id":"#/components/schemas/moderation.banResponse"},"moderation.bansListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["blocked_user","created_at","id"],"properties":{"blocked_user":{"anyOf":[{"type":"object","required":["id","username"],"properties":{"id":{"type":"string"},"username":{"type":"string"}}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"id":{"type":"string"}}}}},"$id":"#/components/schemas/moderation.bansListResponse"},"moderation.createBanBody":{"type":"object","required":["user_id"],"properties":{"user_id":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/moderation.createBanBody"},"events.createSubscriptionBody":{"type":"object","required":["event_types","url"],"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_types":{"minItems":1,"type":"array","items":{"type":"string"}},"url":{"format":"uri","minLength":1,"type":"string"}},"$id":"#/components/schemas/events.createSubscriptionBody"},"events.createSubscriptionResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","allOf":[{"type":"object","required":["created_at","description","event_types","id","status","url"],"properties":{"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_types":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}}},{"type":"object","required":["signing_secret"],"properties":{"signing_secret":{"type":"string"}}}]}},"$id":"#/components/schemas/events.createSubscriptionResponse"},"events.idParams":{"type":"object","required":["id"],"properties":{"id":{"minLength":1,"type":"string"}},"$id":"#/components/schemas/categories.idParams"},"events.subscriptionsListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","required":["created_at","description","event_types","id","status","url"],"properties":{"created_at":{"anyOf":[{"type":"Date"},{"format":"date-time","type":"string"},{"format":"date","type":"string"},{"type":"number"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_types":{"type":"array","items":{"type":"string"}},"id":{"type":"string"},"status":{"type":"string"},"url":{"type":"string"}}}}},"$id":"#/components/schemas/events.subscriptionsListResponse"}}}}