{"openapi":"3.1.0","info":{"title":"LaunchDarkly Code References (BYOK) API","version":"0.1.0","description":"LaunchDarkly Code References (BYOK) lets an AI assistant read your own LaunchDarkly Code References data through the LaunchDarkly Code References API with a key you supply (LaunchDarkly API access token (a Reader role token is enough; commercial site, not EU or federal)). Read-only: 7 tools (list_repositories, get_repository, list_branches, get_branch, get_project_reference_statistics,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-launchdarkly-code-refs.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-launchdarkly-code-refs/docs"},"termsOfService":"https://connectorbay.com/byok-launchdarkly-code-refs/terms"},"servers":[{"url":"https://byok-launchdarkly-code-refs.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-launchdarkly-code-refs/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_repositories":{"post":{"operationId":"list_repositories","summary":"List the repositories that send code references to LaunchDarkly with host type, default branch and enabled state. Option","description":"List the repositories that send code references to LaunchDarkly with host type, default branch and enabled state. Optionally limit to repositories that reference a project's or one flag's key. Use for \"Which code repositories report LaunchDarkly flag references\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_key":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only repositories with references to flags of this project key.","title":"Project Key"},"flag_key":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only repositories with references to this flag key (use with project_key).","title":"Flag Key"}},"title":"list_repositoriesArguments","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_repository":{"post":{"operationId":"get_repository","summary":"Get one code reference repository with its source link, host type, default branch, enabled state and links to its branch","description":"Get one code reference repository with its source link, host type, default branch, enabled state and links to its branches. Use for \"Show the LaunchDarkly code reference settings of the web-app repository\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"repository_name":{"description":"Name of the code reference repository (from list_repositories), for example 'web-app'.","maxLength":200,"title":"Repository Name","type":"string"}},"required":["repository_name"],"title":"get_repositoryArguments","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_branches":{"post":{"operationId":"list_branches","summary":"List the branches of a code reference repository with head commit and last sync time (Unix milliseconds). The file-level","description":"List the branches of a code reference repository with head commit and last sync time (Unix milliseconds). The file-level references are left out. Use for \"Which branches of web-app have been scanned for LaunchDarkly flags\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"repository_name":{"description":"Name of the code reference repository (from list_repositories), for example 'web-app'.","maxLength":200,"title":"Repository Name","type":"string"}},"required":["repository_name"],"title":"list_branchesArguments","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_branch":{"post":{"operationId":"get_branch","summary":"Get one branch of a code reference repository with head commit and last sync time. Use for \"When was the main branch of ","description":"Get one branch of a code reference repository with head commit and last sync time. Use for \"When was the main branch of web-app last scanned for LaunchDarkly flags\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"repository_name":{"description":"Name of the code reference repository (from list_repositories), for example 'web-app'.","maxLength":200,"title":"Repository Name","type":"string"},"branch_name":{"description":"Branch name, for example 'main'; slashes are encoded for you.","maxLength":250,"title":"Branch Name","type":"string"}},"required":["repository_name","branch_name"],"title":"get_branchArguments","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_reference_statistics":{"post":{"operationId":"get_project_reference_statistics","summary":"Show, for one project, each flag key mapped to the repositories where it appears, with file and hunk counts and latest c","description":"Show, for one project, each flag key mapped to the repositories where it appears, with file and hunk counts and latest commit time per repository. Use for \"How many code references does each flag in the default LaunchDarkly project have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_key":{"description":"Key of the LaunchDarkly project, for example 'default'.","maxLength":100,"title":"Project Key","type":"string"},"flag_key":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only statistics for this flag key.","title":"Flag Key"}},"required":["project_key"],"title":"get_project_reference_statisticsArguments","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_reference_projects":{"post":{"operationId":"list_reference_projects","summary":"List the projects that have code reference statistics, with links to their statistics. Use for \"Which LaunchDarkly proje","description":"List the projects that have code reference statistics, with links to their statistics. Use for \"Which LaunchDarkly projects have code reference statistics\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_reference_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/list_extinctions":{"post":{"operationId":"list_extinctions","summary":"List flags that were removed from code (extinctions) with the repository, branch and time they disappeared, optionally f","description":"List flags that were removed from code (extinctions) with the repository, branch and time they disappeared, optionally filtered by project, flag, repository or branch. Use for \"Which LaunchDarkly flags have been removed from code recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"repo_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only extinctions in this repository.","title":"Repo Name"},"branch_name":{"anyOf":[{"maxLength":250,"type":"string"},{"type":"null"}],"default":null,"description":"Only extinctions on this branch.","title":"Branch Name"},"project_key":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only flags of this project key.","title":"Project Key"},"flag_key":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only this flag key (use with project_key).","title":"Flag Key"},"from_time":{"anyOf":[{"maximum":9999999999999,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only extinctions at or after this Unix time in milliseconds.","title":"From Time"},"to_time":{"anyOf":[{"maximum":9999999999999,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only extinctions at or before this Unix time in milliseconds.","title":"To Time"}},"title":"list_extinctionsArguments","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}}}}