{"openapi":"3.1.0","info":{"title":"CVAT projects, tasks, jobs, labels and quality reports (your token) API","version":"0.1.0","description":"CVAT projects, tasks, jobs, labels and quality reports (your token) lets an AI assistant read your own CVAT data through the CVAT API with a key you supply (CVAT personal access token). Read-only: 11 tools (get_server_info, list_projects, get_project, list_tasks, get_task, get_task_creation_status, list_jobs, list_labels, list_cloud_storages, list_organizations, list_quality_reports). The BYOK...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-cvat.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-cvat/docs"},"termsOfService":"https://connectorbay.com/byok-cvat/terms"},"servers":[{"url":"https://byok-cvat.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-cvat/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/get_server_info":{"post":{"operationId":"get_server_info","summary":"Show the CVAT server's name, version and description. Use for \"Which CVAT version is app.cvat.ai running\".","description":"Show the CVAT server's name, version and description. Use for \"Which CVAT version is app.cvat.ai running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_server_infoArguments","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 CVAT projects with owner, status, dimension and creation and update times. Filter by status or search text. Use for","description":"List CVAT projects with owner, status, dimension and creation and update times. Filter by status or search text. Use for \"Which of my CVAT projects are still in annotation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"status":{"anyOf":[{"enum":["annotation","validation","completed"],"type":"string"},{"type":"null"}],"default":null,"description":"Only projects with this status.","title":"Status"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over names and owners.","title":"Search"},"org":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Organization slug to scope the list to. Omit for everything the account can see.","title":"Org"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"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 CVAT project by id: owner, status, dimension, storage locations and task count. Use for \"Show details of CVAT pr","description":"Get one CVAT project by id: owner, status, dimension, storage locations and task count. Use for \"Show details of CVAT project 42\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Project id.","title":"Id","type":"integer"}},"required":["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_tasks":{"post":{"operationId":"list_tasks","summary":"List CVAT tasks with status, media type, size in frames, project and job counts. Filter by project, status, media type o","description":"List CVAT tasks with status, media type, size in frames, project and job counts. Filter by project, status, media type or name. Use for \"Which CVAT tasks in project 42 are not completed yet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only tasks of this project id.","title":"Project Id"},"status":{"anyOf":[{"enum":["annotation","validation","completed"],"type":"string"},{"type":"null"}],"default":null,"description":"Only tasks with this status.","title":"Status"},"media_type":{"anyOf":[{"enum":["image","point_cloud","audio"],"type":"string"},{"type":"null"}],"default":null,"description":"Only tasks of this media type.","title":"Media Type"},"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Exact task name.","title":"Name"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over names and owners.","title":"Search"},"org":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Organization slug to scope the list to. Omit for everything the account can see.","title":"Org"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"title":"list_tasksArguments","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_task":{"post":{"operationId":"get_task","summary":"Get one CVAT task by id: status, mode, media type, frame count, segment size, job counts and dates. Use for \"Show detail","description":"Get one CVAT task by id: status, mode, media type, frame count, segment size, job counts and dates. Use for \"Show details of CVAT task 101\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Task id.","title":"Id","type":"integer"}},"required":["id"],"title":"get_taskArguments","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_task_creation_status":{"post":{"operationId":"get_task_creation_status","summary":"Check whether a CVAT task has finished being created from its uploaded data: state, progress and message. Use for \"Is CV","description":"Check whether a CVAT task has finished being created from its uploaded data: state, progress and message. Use for \"Is CVAT task 101 finished processing its data\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Task id.","title":"Id","type":"integer"}},"required":["id"],"title":"get_task_creation_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_jobs":{"post":{"operationId":"list_jobs","summary":"List CVAT jobs with stage, state, frame range, task and project, and open issue count. Filter by task, project, stage or","description":"List CVAT jobs with stage, state, frame range, task and project, and open issue count. Filter by task, project, stage or state. Use for \"Which CVAT jobs in task 101 are still in progress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"task_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only jobs of this task id.","title":"Task Id"},"project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only jobs of this project id.","title":"Project Id"},"stage":{"anyOf":[{"enum":["annotation","validation","acceptance"],"type":"string"},{"type":"null"}],"default":null,"description":"Only jobs in this stage.","title":"Stage"},"state":{"anyOf":[{"enum":["new","in progress","completed","rejected"],"type":"string"},{"type":"null"}],"default":null,"description":"Only jobs in this state.","title":"State"},"org":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Organization slug to scope the list to. Omit for everything the account can see.","title":"Org"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"title":"list_jobsArguments","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 annotation labels of a project, task or job with color, type and attribute definitions. Use for \"What labels do","description":"List the annotation labels of a project, task or job with color, type and attribute definitions. Use for \"What labels does CVAT project 42 use\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Labels of this project id.","title":"Project Id"},"task_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Labels of this task id.","title":"Task Id"},"job_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Labels of this job id.","title":"Job Id"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"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/list_cloud_storages":{"post":{"operationId":"list_cloud_storages","summary":"List cloud storage connections (S3, Azure container, Google Cloud Storage) with provider, resource name and credential t","description":"List cloud storage connections (S3, Azure container, Google Cloud Storage) with provider, resource name and credential type. Credentials are not returned. Use for \"Which cloud storages are connected to my CVAT account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"provider_type":{"anyOf":[{"enum":["AWS_S3_BUCKET","AZURE_CONTAINER","GOOGLE_CLOUD_STORAGE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this provider.","title":"Provider Type"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over names and owners.","title":"Search"},"org":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Organization slug to scope the list to. Omit for everything the account can see.","title":"Org"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"title":"list_cloud_storagesArguments","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_organizations":{"post":{"operationId":"list_organizations","summary":"List the CVAT organizations the account belongs to with slug, name and creation date. Use for \"Which CVAT organizations ","description":"List the CVAT organizations the account belongs to with slug, name and creation date. Use for \"Which CVAT organizations am I a member of\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Free-text search over names and owners.","title":"Search"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"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_quality_reports":{"post":{"operationId":"list_quality_reports","summary":"List annotation quality reports for jobs, tasks or projects with conflict and error counts and validation frame share. U","description":"List annotation quality reports for jobs, tasks or projects with conflict and error counts and validation frame share. Use for \"What are the latest CVAT quality reports for task 101\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"task_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only reports of this task id.","title":"Task Id"},"project_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only reports of this project id.","title":"Project Id"},"job_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Only reports of this job id.","title":"Job Id"},"target":{"anyOf":[{"enum":["job","task","project"],"type":"string"},{"type":"null"}],"default":null,"description":"Only reports of this target type.","title":"Target"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Results per page (1 to 100).","title":"Page Size"}},"title":"list_quality_reportsArguments","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}}}}