{"openapi":"3.1.0","info":{"title":"Bri Authorized API Contract","version":"2026-08-12","summary":"Authenticated contract for Subscription-backed Podcast Briefings.","description":"Bri lets authorized agents and users manage RSS Subscriptions and create source-backed Podcast Briefings. This contract is public for discovery and planning, but access requires Bri-issued Skill Session or connector credentials.","contact":{"email":"hi@bri.so","url":"https://bri.so/contact"}},"servers":[{"url":"https://bri.so","description":"Bri Worker gateway"}],"externalDocs":{"description":"Bri agent reference","url":"https://bri.so/llms-full.txt"},"tags":[{"name":"Auth","description":"Skill Session and agent authentication entrypoints."},{"name":"Subscriptions","description":"Manage RSS Subscriptions."},{"name":"Feed Items","description":"List and read Feed Items visible through Subscriptions."},{"name":"Briefings","description":"Create and inspect Podcast Briefings."},{"name":"Podcast Hosts","description":"Discover provider-neutral Podcast presenters."},{"name":"Settings","description":"Read and update small user preferences."}],"paths":{"/api/v1/auth/skill/start":{"get":{"operationId":"startSkillAuth","tags":["Auth"],"summary":"Start Bri Skill authentication with PKCE and redirect to the authorize flow.","security":[],"parameters":[{"name":"code_challenge","in":"query","required":true,"schema":{"type":"string","minLength":1},"description":"PKCE code challenge generated by the Skill client."},{"name":"state","in":"query","required":true,"schema":{"type":"string","minLength":1},"description":"Opaque client state returned after authorization."}],"responses":{"302":{"description":"Redirects the browser to the Bri Skill authorize URL.","headers":{"Location":{"description":"Bri Skill authorize URL.","schema":{"type":"string","format":"uri"}}}},"400":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/subscriptions/list":{"post":{"operationId":"listSubscriptions","tags":["Subscriptions"],"summary":"List active Subscriptions for the authenticated user.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","pattern":"^\\d+:.+$"},"limit":{"type":"integer","minimum":1,"maximum":100},"query":{"type":"string","minLength":1,"maxLength":200}}}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListSubscriptionsResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/subscriptions/create":{"post":{"operationId":"createSubscription","tags":["Subscriptions"],"summary":"Create or reactivate one RSS Subscription.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"feed_url":{"type":"string","format":"uri"},"source_id":{"type":"string","minLength":1}},"required":["feed_url"]}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionResponse"}}}},"400":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/subscriptions/delete":{"post":{"operationId":"deleteSubscription","tags":["Subscriptions"],"summary":"Soft-delete one Subscription owned by the authenticated user.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"source_id":{"type":"string","minLength":1}},"required":["source_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteSubscriptionResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/items/list":{"post":{"operationId":"listFeedItems","tags":["Feed Items"],"summary":"List Feed Items visible through the authenticated user's Subscriptions.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"source_id":{"type":"string","minLength":1},"keyword":{"type":"string","minLength":1},"published_after":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"published_before":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string","pattern":"^\\d+:.+$"},"ids":{"anyOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string","minLength":1}}]},"search_content":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFeedItemsResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/items/get":{"post":{"operationId":"getFeedItem","tags":["Feed Items"],"summary":"Read one Feed Item through a Skill Session.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","pattern":"^\\d+$"},"max_chars":{"default":12000,"type":"integer","minimum":1,"maximum":20000},"include_raw":{"default":false,"type":"boolean"},"item_id":{"type":"string","minLength":1}},"required":["item_id"]}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFeedItemResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/hosts/list":{"post":{"operationId":"listPodcastHosts","tags":["Podcast Hosts"],"summary":"List enabled Podcast Hosts in stable catalog order.","security":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListPodcastHostsResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/artifacts/compositions/create":{"post":{"operationId":"createBriefing","tags":["Briefings"],"summary":"Request a source-backed Podcast Briefing.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"artifact_type":{"type":"string","const":"audio_brief"},"capacity":{"type":"object","properties":{"target_length_seconds":{"type":"integer","minimum":180,"maximum":3600},"target_items":{"type":"integer","minimum":1,"maximum":500},"target_topics":{"type":"integer","minimum":1,"maximum":100}},"additionalProperties":false},"host_ids":{"minItems":1,"maxItems":2,"type":"array","items":{"type":"string","minLength":1}},"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"refs":{"maxItems":20,"type":"array","items":{"type":"object","properties":{"key":{"type":"string","pattern":"^ref_([1-9]|1[0-9]|20)$"},"source_id":{"type":"string","minLength":1},"type":{"type":"string","const":"source"}},"required":["key","source_id","type"],"additionalProperties":false}},"scope":{"type":"object","properties":{"excluded_source_ids":{"type":"array","items":{"type":"string","minLength":1}},"item_ids":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1}},"query":{"type":"string","minLength":1},"source_ids":{"type":"array","items":{"type":"string","minLength":1}},"time_window":{"type":"object","properties":{"end_ms":{"type":"integer","minimum":0,"maximum":9007199254740991},"start_ms":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["end_ms","start_ms"]}},"additionalProperties":false},"timezone":{"type":"string"},"user_preference_context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"user_request":{"type":"string","minLength":1,"maxLength":1024}},"required":["artifact_type","user_request"],"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactCompositionResponse"}}}},"202":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactCompositionResponse"}}}},"400":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactCompositionSubscriptionError"}}}},"429":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactCompositionAllowanceError"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/artifacts/list":{"post":{"operationId":"listBriefings","tags":["Briefings"],"summary":"List recent Briefings for the authenticated user.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"limit":{"type":"integer","minimum":1,"maximum":50},"type":{"anyOf":[{"type":"string","const":"audio_brief"},{"type":"null"}]}},"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListArtifactsResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/artifacts/get":{"post":{"operationId":"getBriefing","tags":["Briefings"],"summary":"Get status and public links for one Briefing.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","minLength":1}},"required":["id"],"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/me/get":{"post":{"operationId":"getMe","tags":["Settings"],"summary":"Read the signed-in dashboard profile and small Bri preferences.","security":[{"dashboardSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/settings/get":{"post":{"operationId":"getSettings","tags":["Settings"],"summary":"Read the authenticated user's small Bri preferences.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/settings/update":{"post":{"operationId":"updateSettings","tags":["Settings"],"summary":"Update small Bri preferences such as language or timezone.","security":[{"skillSession":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"timezone":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false}}}},"responses":{"200":{"description":"JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsResponse"}}}},"400":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"default":{"description":"Structured JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"dashboardSession":{"type":"apiKey","in":"cookie","name":"__Secure-better-auth.session_token","description":"Better Auth dashboard browser session cookie."},"skillSession":{"type":"http","scheme":"bearer","bearerFormat":"Bri Skill Session","description":"Skill Session bearer token from the Bri Auth Entry or pair flow."}},"schemas":{"Artifact":{"type":"object","properties":{"id":{"type":"string"},"artifact_id":{"type":"string"},"artifact_data":{},"audio_author":{"type":"string"},"audio_duration_ms":{"type":"number"},"audio_size_bytes":{"type":"number"},"audio_transcript_segments":{"type":"array","items":{"type":"object","properties":{"duration_ms":{"type":"number"},"speaker":{"type":"string"},"start_ms":{"type":"number"},"text":{"type":"string"}},"required":["duration_ms","text"],"additionalProperties":false}},"audio_url":{"type":"string"},"content_type":{"type":"string","enum":["application/json","audio/mpeg"]},"cover_image_url":{"type":"string"},"coverage_summary":{"type":"object","properties":{"covered_unique_news_count":{"type":"number"},"coverage_rate":{"type":"number"},"total_news_count":{"type":"number"}},"required":["covered_unique_news_count","coverage_rate","total_news_count"],"additionalProperties":false},"created_at":{"type":"number"},"download_url":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},"host_ids":{"type":"array","items":{"type":"string"}},"hosts":{"type":"array","items":{"type":"string"}},"production_progress":{"type":"object","properties":{"label":{"type":"string"},"overall_percent":{"type":"number"},"updated_at":{"type":"number"}},"required":["label","overall_percent","updated_at"],"additionalProperties":false},"quick_read_artifact_id":{"type":"string"},"status":{"type":"string","enum":["queued","composing","rendering","assembling","ready","failed","composition_failed"]},"title":{"type":"string"},"transcript_text":{"type":"string"},"type":{"type":"string","enum":["audio_brief","briefing_page"]},"updated_at":{"type":"number"},"viewer_url":{"type":"string"}},"required":["id","artifact_id","host_ids","hosts","status","title","type","viewer_url"],"additionalProperties":false},"ArtifactCompositionAllowanceError":{"anyOf":[{"type":"object","properties":{"artifact_type":{"type":"string","const":"audio_brief"},"error":{"type":"string","const":"anonymous_web_podcast_allowance_exhausted"},"limit":{"type":"number","const":1},"message":{"type":"string"},"next_action":{"type":"string","const":"sign_in"}},"required":["artifact_type","error","limit","message","next_action"],"additionalProperties":false},{"type":"object","properties":{"artifact_type":{"type":"string","const":"audio_brief"},"error":{"type":"string","const":"allowance_exhausted"},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"message":{"type":"string"},"next_action":{"type":"string","const":"wait_until_reset"},"next_generation_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["artifact_type","error","limit","message","next_action","next_generation_at"],"additionalProperties":false}]},"ArtifactCompositionResponse":{"type":"object","properties":{"accepted":{"type":"boolean","const":true},"artifact_id":{"type":"string"},"status":{"type":"string","const":"composing"},"viewer_url":{"type":"string"}},"required":["accepted","artifact_id","status","viewer_url"],"additionalProperties":false},"ArtifactCompositionSubscriptionError":{"type":"object","properties":{"error":{"type":"string","const":"no_active_subscriptions"},"message":{"type":"string"},"next_action":{"type":"string","const":"manage_subscriptions"}},"required":["error","message","next_action"],"additionalProperties":false},"ArtifactResponse":{"type":"object","properties":{"artifact":{"type":"object","properties":{"id":{"type":"string"},"artifact_id":{"type":"string"},"artifact_data":{},"audio_author":{"type":"string"},"audio_duration_ms":{"type":"number"},"audio_size_bytes":{"type":"number"},"audio_transcript_segments":{"type":"array","items":{"type":"object","properties":{"duration_ms":{"type":"number"},"speaker":{"type":"string"},"start_ms":{"type":"number"},"text":{"type":"string"}},"required":["duration_ms","text"],"additionalProperties":false}},"audio_url":{"type":"string"},"content_type":{"type":"string","enum":["application/json","audio/mpeg"]},"cover_image_url":{"type":"string"},"coverage_summary":{"type":"object","properties":{"covered_unique_news_count":{"type":"number"},"coverage_rate":{"type":"number"},"total_news_count":{"type":"number"}},"required":["covered_unique_news_count","coverage_rate","total_news_count"],"additionalProperties":false},"created_at":{"type":"number"},"download_url":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},"host_ids":{"type":"array","items":{"type":"string"}},"hosts":{"type":"array","items":{"type":"string"}},"production_progress":{"type":"object","properties":{"label":{"type":"string"},"overall_percent":{"type":"number"},"updated_at":{"type":"number"}},"required":["label","overall_percent","updated_at"],"additionalProperties":false},"quick_read_artifact_id":{"type":"string"},"status":{"type":"string","enum":["queued","composing","rendering","assembling","ready","failed","composition_failed"]},"title":{"type":"string"},"transcript_text":{"type":"string"},"type":{"type":"string","enum":["audio_brief","briefing_page"]},"updated_at":{"type":"number"},"viewer_url":{"type":"string"}},"required":["id","artifact_id","host_ids","hosts","status","title","type","viewer_url"],"additionalProperties":false}},"required":["artifact"],"additionalProperties":false},"CreateSubscriptionResponse":{"type":"object","properties":{"created":{"type":"boolean"},"source":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","const":"rss"},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","format":"uri"},"site_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"last_success_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updated_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","type","title","feed_url","site_url","last_success_at","last_error","created_at","updated_at"],"additionalProperties":false}},"required":["created","source"],"additionalProperties":false},"DashboardProfile":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"}},"required":["id","name","email","image"],"additionalProperties":false},"DeleteSubscriptionResponse":{"type":"object","properties":{"deleted":{"type":"boolean","const":true}},"required":["deleted"],"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":false},"FeedItemSummary":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","minLength":1}},"required":["id","title","feed_url"],"additionalProperties":false}},"required":["id","title","author","url","published_at","summary","created_at","source"],"additionalProperties":false},"GetFeedItemResponse":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","minLength":1}},"required":["id","title","feed_url"],"additionalProperties":false},"content_text":{"anyOf":[{"type":"string"},{"type":"null"}]},"raw":{"type":"object","properties":{"content_raw":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"required":["id","title","author","url","published_at","summary","created_at","source"],"additionalProperties":false},"next_content_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["item","next_content_cursor"],"additionalProperties":false},"ListArtifactsResponse":{"type":"object","properties":{"artifacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"artifact_id":{"type":"string"},"artifact_data":{},"audio_author":{"type":"string"},"audio_duration_ms":{"type":"number"},"audio_size_bytes":{"type":"number"},"audio_transcript_segments":{"type":"array","items":{"type":"object","properties":{"duration_ms":{"type":"number"},"speaker":{"type":"string"},"start_ms":{"type":"number"},"text":{"type":"string"}},"required":["duration_ms","text"],"additionalProperties":false}},"audio_url":{"type":"string"},"content_type":{"type":"string","enum":["application/json","audio/mpeg"]},"cover_image_url":{"type":"string"},"coverage_summary":{"type":"object","properties":{"covered_unique_news_count":{"type":"number"},"coverage_rate":{"type":"number"},"total_news_count":{"type":"number"}},"required":["covered_unique_news_count","coverage_rate","total_news_count"],"additionalProperties":false},"created_at":{"type":"number"},"download_url":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false},"host_ids":{"type":"array","items":{"type":"string"}},"hosts":{"type":"array","items":{"type":"string"}},"production_progress":{"type":"object","properties":{"label":{"type":"string"},"overall_percent":{"type":"number"},"updated_at":{"type":"number"}},"required":["label","overall_percent","updated_at"],"additionalProperties":false},"quick_read_artifact_id":{"type":"string"},"status":{"type":"string","enum":["queued","composing","rendering","assembling","ready","failed","composition_failed"]},"title":{"type":"string"},"transcript_text":{"type":"string"},"type":{"type":"string","enum":["audio_brief","briefing_page"]},"updated_at":{"type":"number"},"viewer_url":{"type":"string"}},"required":["id","artifact_id","host_ids","hosts","status","title","type","viewer_url"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["artifacts"],"additionalProperties":false},"ListFeedItemsResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"author":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"published_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source":{"type":"object","properties":{"id":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","minLength":1}},"required":["id","title","feed_url"],"additionalProperties":false}},"required":["id","title","author","url","published_at","summary","created_at","source"],"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["items","next_cursor"],"additionalProperties":false},"ListPodcastHostsResponse":{"type":"object","properties":{"hosts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"is_default":{"type":"boolean"},"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"name":{"type":"string"}},"required":["id","is_default","language","name"],"additionalProperties":false}}},"required":["hosts"],"additionalProperties":false},"ListSubscriptionsResponse":{"type":"object","properties":{"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","const":"rss"},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","format":"uri"},"site_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"last_success_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updated_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","type","title","feed_url","site_url","last_success_at","last_error","created_at","updated_at"],"additionalProperties":false}}},"required":["sources"],"additionalProperties":false},"MeResponse":{"type":"object","properties":{"settings":{"type":"object","properties":{"profile":{"type":"object","properties":{"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"timezone":{"type":"string"}},"required":["language","timezone"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false},"user":{"type":"object","properties":{"id":{"type":"string","minLength":1},"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"type":"string"}},"required":["id","name","email","image"],"additionalProperties":false}},"required":["settings","user"],"additionalProperties":false},"PodcastHost":{"type":"object","properties":{"id":{"type":"string"},"is_default":{"type":"boolean"},"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"name":{"type":"string"}},"required":["id","is_default","language","name"],"additionalProperties":false},"ProductionProgress":{"type":"object","properties":{"label":{"type":"string"},"overall_percent":{"type":"number"},"updated_at":{"type":"number"}},"required":["label","overall_percent","updated_at"],"additionalProperties":false},"SettingsResponse":{"type":"object","properties":{"profile":{"type":"object","properties":{"language":{"type":"string","enum":["en","zh","es","pt","de","fr","ja"]},"timezone":{"type":"string"}},"required":["language","timezone"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false},"Source":{"type":"object","properties":{"id":{"type":"string","minLength":1},"type":{"type":"string","const":"rss"},"title":{"type":"string","minLength":1},"feed_url":{"type":"string","format":"uri"},"site_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"last_success_at":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"updated_at":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","type","title","feed_url","site_url","last_success_at","last_error","created_at","updated_at"],"additionalProperties":false}}}}