{"openapi":"3.1.0","info":{"title":"FeedOut.ai API","description":"Versioned REST API for FeedOut.ai.\n\n**Auth:** send your key as `Authorization: Bearer fo_live_…` (or `X-API-Key`). Create keys in Settings → API.\n\n**Scopes:** `read` (GET), `write` (create/modify), `publish` (send outputs to destinations).\n\n**Rate limits (per hour, per account):** Free 100 · Creator 1,000 · Pro 5,000 · Agency 20,000. Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.\n\n**Webhooks:** events are POSTed with `X-FeedOut-Signature: t=<unix>,v1=<hex HMAC-SHA256 of \"t.body\" with your secret>`. Failed deliveries are retried with exponential backoff up to 6 times.","version":"1.0.0"},"servers":[{"url":"/api/v1"}],"paths":{"/me":{"get":{"tags":["Account"],"summary":"Me","operationId":"me_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/usage":{"get":{"tags":["Account"],"summary":"Usage","operationId":"usage_usage_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/groups":{"get":{"tags":["Groups"],"summary":"List Groups","operationId":"list_groups_groups_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/groups/{group_id}":{"get":{"tags":["Groups"],"summary":"Get Group","operationId":"get_group_groups__group_id__get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["Groups"],"summary":"Patch Group","operationId":"patch_group_groups__group_id__patch","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupPatch"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/feeds":{"get":{"tags":["Feeds"],"summary":"List Feeds","operationId":"list_feeds_feeds_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/groups/{group_id}/items":{"get":{"tags":["Items"],"summary":"Group Items","operationId":"group_items_groups__group_id__items_get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"integer","title":"Group Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/outputs":{"get":{"tags":["Outputs"],"summary":"List Outputs","operationId":"list_outputs_outputs_get","parameters":[{"name":"group_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Group Id"}},{"name":"since_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Since Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"include_article","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Article"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/outputs/{output_id}":{"get":{"tags":["Outputs"],"summary":"Get Output","operationId":"get_output_outputs__output_id__get","parameters":[{"name":"output_id","in":"path","required":true,"schema":{"type":"integer","title":"Output Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/outputs/{output_id}/publish":{"post":{"tags":["Publishing"],"summary":"Publish Output","operationId":"publish_output_outputs__output_id__publish_post","parameters":[{"name":"output_id","in":"path","required":true,"schema":{"type":"integer","title":"Output Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishBody"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/destinations":{"get":{"tags":["Publishing"],"summary":"List Destinations","operationId":"list_destinations_destinations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/publish-jobs":{"get":{"tags":["Publishing"],"summary":"Publish Jobs","operationId":"publish_jobs_publish_jobs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks":{"get":{"tags":["Webhooks"],"summary":"List Webhooks","operationId":"list_webhooks_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["Webhooks"],"summary":"Create Webhook","operationId":"create_webhook_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/{webhook_id}":{"delete":{"tags":["Webhooks"],"summary":"Delete Webhook","operationId":"delete_webhook_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"GroupPatch":{"properties":{"status":{"anyOf":[{"type":"string","pattern":"^(active|paused)$"},{"type":"null"}],"title":"Status"},"topic_include":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Include"},"topic_exclude":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Exclude"},"topic_mode":{"anyOf":[{"type":"string","pattern":"^(any|all)$"},{"type":"null"}],"title":"Topic Mode"}},"type":"object","title":"GroupPatch"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"PublishBody":{"properties":{"destination_ids":{"items":{"type":"integer"},"type":"array","title":"Destination Ids"}},"type":"object","required":["destination_ids"],"title":"PublishBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookIn":{"properties":{"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events","default":["output.created"]}},"type":"object","required":["url"],"title":"WebhookIn"}}}}