{"schemaVersion":1,"release":"83c074d731b61522f1b354b1549b8f4e4be0412c","service":"sourcefoundry","purpose":"Build source feeds that stay fresh and retrieve new source items for agents and applications.","baseUrl":"https://sourcefoundry.4agents.fyi","discovery":{"openapi":"https://sourcefoundry.4agents.fyi/openapi.json","agentGuide":"https://sourcefoundry.4agents.fyi/agent.md","llms":"https://sourcefoundry.4agents.fyi/llms.txt","capabilities":"https://sourcefoundry.4agents.fyi/v1/meta"},"authentication":{"type":"http-bearer","environmentVariable":"SOURCEFOUNDRY_API_TOKEN","header":"Authorization: Bearer $SOURCEFOUNDRY_API_TOKEN","note":"Use a token supplied through the agent runtime secret store. Never put it in source configuration or prompts."},"workflow":["Read /v1/meta or the OpenAPI document.","Create an autonomous workspace and one-time tenant-scoped credential with POST /v1/agent-enrollments.","Describe the required source supply with POST /v1/source-feeds and a stable Idempotency-Key.","Enqueue a bounded collection run with POST /v1/source-feeds/{sourceFeedId}/runs.","Read neutral candidates with GET /v1/source-feeds/{sourceFeedId}/candidates and inspect operational evidence at /health."],"guardrails":["Source upserts are idempotent by tenant and source URL.","Active source-fetch jobs are deduplicated by tenant and source.","Provider API keys, cookies, and session tokens are managed by SourceFoundry and must never be sent in an API request.","Autonomous credentials enqueue work but cannot run a job directly.","Autonomous workspaces are limited to 3 sources, a 720-minute minimum interval, and 10 items per fetch."]}