{"openapi":"3.1.0","info":{"title":"Depot Builds (BYOK) API","version":"0.1.0","description":"Depot Builds (BYOK) lets an AI assistant read your own Depot Builds data through the Depot Builds API with a key you supply (organization API token). Read-only: 7 tools (list_organizations, list_projects, get_project, list_builds, get_build, list_project_usage, get_project_usage). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-depot-builds.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-depot-builds/docs"},"termsOfService":"https://connectorbay.com/byok-depot-builds/terms"},"servers":[{"url":"https://byok-depot-builds.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-depot-builds/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_organizations":{"post":{"operationId":"list_organizations","summary":"List the Depot organizations the token can see, with ID, name and creation time. Use for \"Which Depot organization does ","description":"List the Depot organizations the token can see, with ID, name and creation time. Use for \"Which Depot organization does my token belong to\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_organizationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_projects":{"post":{"operationId":"list_projects","summary":"List the Depot projects of the organization (a project is an isolated build cache) with region, cache policy, timeout an","description":"List the Depot projects of the organization (a project is an isolated build cache) with region, cache policy, timeout and concurrency limit. Needs an organization token. Use for \"Which Depot build projects does my organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"The next_page_token from the previous answer, to get the following page.","title":"Page Token"}},"title":"list_projectsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_project":{"post":{"operationId":"get_project","summary":"Get one Depot project: name, region, cache policy (days and gigabytes kept), build timeout and concurrency limit. Needs ","description":"Get one Depot project: name, region, cache policy (days and gigabytes kept), build timeout and concurrency limit. Needs an organization token. Use for \"What is the cache policy of Depot project abc123def4\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Depot project ID (from list_projects), for example 'abc123def4'.","maxLength":100,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"get_projectArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_builds":{"post":{"operationId":"list_builds","summary":"List the builds of a Depot project, newest first, with status, timings, duration, cache time saved and cached step count","description":"List the builds of a Depot project, newest first, with status, timings, duration, cache time saved and cached step counts. Use for \"What were the latest builds of Depot project abc123def4\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Depot project ID (from list_projects), for example 'abc123def4'.","maxLength":100,"title":"Project Id","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"The next_page_token from the previous answer, to get the following page.","title":"Page Token"}},"required":["project_id"],"title":"list_buildsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_build":{"post":{"operationId":"get_build","summary":"Get one Depot build: status, timestamps, duration, seconds saved by the cache and cached versus total steps. Use for \"Ho","description":"Get one Depot build: status, timestamps, duration, seconds saved by the cache and cached versus total steps. Use for \"How long did Depot build b1c2d3e4f5 take and how much was cached\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"build_id":{"description":"Depot build ID (from list_builds).","maxLength":100,"title":"Build Id","type":"string"}},"required":["build_id"],"title":"get_buildArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_project_usage":{"post":{"operationId":"list_project_usage","summary":"List build count, build seconds and layer cache size per project for a time period. Use for \"How many Depot builds did e","description":"List build count, build seconds and layer cache size per project for a time period. Use for \"How many Depot builds did each project run in October 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_at":{"description":"Start of the period as an ISO 8601 UTC time, for example 2026-10-01T00:00:00Z.","maxLength":40,"title":"Start At","type":"string"},"end_at":{"description":"End of the period as an ISO 8601 UTC time, for example 2026-11-01T00:00:00Z.","maxLength":40,"title":"End At","type":"string"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many results to return per page (1 to 100).","title":"Page Size"},"page_token":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"The next_page_token from the previous answer, to get the following page.","title":"Page Token"}},"required":["start_at","end_at"],"title":"list_project_usageArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_project_usage":{"post":{"operationId":"get_project_usage","summary":"Get build count, build seconds and layer cache size for one Depot project over a time period. Use for \"How much did Depo","description":"Get build count, build seconds and layer cache size for one Depot project over a time period. Use for \"How much did Depot project abc123def4 build in October 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Depot project ID (from list_projects), for example 'abc123def4'.","maxLength":100,"title":"Project Id","type":"string"},"start_at":{"description":"Start of the period as an ISO 8601 UTC time, for example 2026-10-01T00:00:00Z.","maxLength":40,"title":"Start At","type":"string"},"end_at":{"description":"End of the period as an ISO 8601 UTC time, for example 2026-11-01T00:00:00Z.","maxLength":40,"title":"End At","type":"string"}},"required":["project_id","start_at","end_at"],"title":"get_project_usageArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}