{"openapi":"3.1.0","info":{"title":"Kili Technology (BYOK) API","version":"0.1.0","description":"Kili Technology (BYOK) lets an AI assistant read your own Kili Technology data through the Kili Technology API with a key you supply (Kili API key). Read-only: 12 tools (list_projects, get_project, list_assets, list_assets_by_status, count_assets, count_assets_by_status, list_labels, count_labels, list_issues, list_project_versions, get_organization_usage, list_plugins). The BYOK key travels with...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-kili-technology.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-kili-technology/docs"},"termsOfService":"https://connectorbay.com/byok-kili-technology/terms"},"servers":[{"url":"https://byok-kili-technology.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-kili-technology/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_projects":{"post":{"operationId":"list_projects","summary":"List labeling projects with input type, asset counts and open issues, newest first, optionally filtered by title or arch","description":"List labeling projects with input type, asset counts and open issues, newest first, optionally filtered by title or archive state. Use for \"Which Kili labeling projects do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"},"title":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only projects with exactly this title.","title":"Title"},"archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for archived projects only, false for active only.","title":"Archived"}},"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 labeling project: input type, instructions, quality settings (consensus, honeypot, review coverage), queue statu","description":"Get one labeling project: input type, instructions, quality settings (consensus, honeypot, review coverage), queue status and progress counts. Use for \"Show the details and progress of Kili project clx1abc230000xyz\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"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_assets":{"post":{"operationId":"list_assets","summary":"List the assets (images, texts, videos) of a project with external ID, status, priority and dates; the asset content lin","description":"List the assets (images, texts, videos) of a project with external ID, status, priority and dates; the asset content link is not requested. Use for \"Which assets does Kili project clx1abc230000xyz contain\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"},"external_id":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Only the asset with exactly this external ID (file name).","title":"External Id"}},"required":["project_id"],"title":"list_assetsArguments","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_assets_by_status":{"post":{"operationId":"list_assets_by_status","summary":"List the assets of a project that are in one status (not yet started, ongoing, labeled, reviewed or waiting for review),","description":"List the assets of a project that are in one status (not yet started, ongoing, labeled, reviewed or waiting for review), to see what is left to label or review. Use for \"Which assets of Kili project clx1abc230000xyz are waiting for review\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"status":{"description":"Asset status to list.","enum":["TODO","ONGOING","LABELED","REVIEWED","TO_REVIEW"],"title":"Status","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"}},"required":["project_id","status"],"title":"list_assets_by_statusArguments","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/count_assets":{"post":{"operationId":"count_assets","summary":"Count all assets of a project. Use for \"How many assets does Kili project clx1abc230000xyz have\".","description":"Count all assets of a project. Use for \"How many assets does Kili project clx1abc230000xyz have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"count_assetsArguments","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/count_assets_by_status":{"post":{"operationId":"count_assets_by_status","summary":"Count the assets of a project in one status, to see labeling progress. Use for \"How many assets of Kili project clx1abc2","description":"Count the assets of a project in one status, to see labeling progress. Use for \"How many assets of Kili project clx1abc230000xyz are labeled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"status":{"description":"Asset status to count.","enum":["TODO","ONGOING","LABELED","REVIEWED","TO_REVIEW"],"title":"Status","type":"string"}},"required":["project_id","status"],"title":"count_assets_by_statusArguments","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_labels":{"post":{"operationId":"list_labels","summary":"List the labels of a project with type, author ID, annotation count and time spent; the annotation content itself is not","description":"List the labels of a project with type, author ID, annotation count and time spent; the annotation content itself is not requested. Use for \"Which labels were made in Kili project clx1abc230000xyz\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"}},"required":["project_id"],"title":"list_labelsArguments","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/count_labels":{"post":{"operationId":"count_labels","summary":"Count all labels of a project (annotations by labelers, reviewers and predictions). Use for \"How many labels does Kili p","description":"Count all labels of a project (annotations by labelers, reviewers and predictions). Use for \"How many labels does Kili project clx1abc230000xyz have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"count_labelsArguments","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_issues":{"post":{"operationId":"list_issues","summary":"List the issues and questions raised on a project's assets with status, type and dates. Use for \"What open issues does K","description":"List the issues and questions raised on a project's assets with status, type and dates. Use for \"What open issues does Kili project clx1abc230000xyz have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"},"status":{"anyOf":[{"enum":["OPEN","SOLVED"],"type":"string"},{"type":"null"}],"default":null,"description":"Only issues in this state.","title":"Status"}},"required":["project_id"],"title":"list_issuesArguments","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_versions":{"post":{"operationId":"list_project_versions","summary":"List the saved versions (snapshots) of a project with name and creation date; the download link is not requested. Use fo","description":"List the saved versions (snapshots) of a project with name and creation date; the download link is not requested. Use for \"Which versions does Kili project clx1abc230000xyz have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the Kili project, as returned by list_projects.","maxLength":64,"title":"Project Id","type":"string"},"first":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many results to return (1 to 100).","title":"First"},"skip":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip, for paging (default 0).","title":"Skip"}},"required":["project_id"],"title":"list_project_versionsArguments","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_organization_usage":{"post":{"operationId":"get_organization_usage","summary":"Show the organization's name, license plan, seat count, labeled asset and annotation totals, and active users. Use for \"","description":"Show the organization's name, license plan, seat count, labeled asset and annotation totals, and active users. Use for \"How much has my Kili organization used and which plan is it on\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_organization_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/list_plugins":{"post":{"operationId":"list_plugins","summary":"List the labeling plugins (custom Python handlers) of the organization with name, handler types and projects. Use for \"W","description":"List the labeling plugins (custom Python handlers) of the organization with name, handler types and projects. Use for \"Which Kili plugins are installed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_pluginsArguments","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}}}}