{"openapi":"3.1.0","info":{"title":"Datarobot Projects (BYOK) API","version":"0.1.0","description":"Datarobot Projects (BYOK) lets an AI assistant read your own Datarobot Projects data through the Datarobot Projects API with a key you supply (DataRobot API key (US cloud, app.datarobot.com)). Read-only: 12 tools (list_use_cases, get_use_case, list_use_case_projects, list_use_case_datasets, list_use_case_deployments, list_projects, get_project, list_project_jobs, list_project_models,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-datarobot-projects.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-datarobot-projects/docs"},"termsOfService":"https://connectorbay.com/byok-datarobot-projects/terms"},"servers":[{"url":"https://byok-datarobot-projects.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-datarobot-projects/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_use_cases":{"post":{"operationId":"list_use_cases","summary":"List DataRobot use cases (workspaces that group datasets, projects, models and deployments) with item counts. US cloud o","description":"List DataRobot use cases (workspaces that group datasets, projects, models and deployments) with item counts. US cloud only. Use for \"Which DataRobot use cases do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results (1 to 100, default 25).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only use cases whose name matches this text.","title":"Search"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"-updatedAt","description":"Order of results; prefix - for descending, for example -updatedAt, name or -createdAt.","title":"Order By"},"use_case_type":{"anyOf":[{"enum":["all","general","walkthrough"],"type":"string"},{"type":"null"}],"default":"all","description":"Which use cases: all, general or walkthrough.","title":"Use Case Type"}},"title":"list_use_casesArguments","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_use_case":{"post":{"operationId":"get_use_case","summary":"Get one use case with its description and counts of datasets, models, deployments, applications and notebooks. Use for \"","description":"Get one use case with its description and counts of datasets, models, deployments, applications and notebooks. Use for \"Show DataRobot use case 65a1b2c3d4e5f6a7b8c9d002\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case_id":{"description":"ID of the use case, as returned by list_use_cases.","maxLength":200,"title":"Use Case Id","type":"string"}},"required":["use_case_id"],"title":"get_use_caseArguments","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_use_case_projects":{"post":{"operationId":"list_use_case_projects","summary":"List the modeling projects in a use case with target, dataset, model count and last activity. Use for \"Which projects ar","description":"List the modeling projects in a use case with target, dataset, model count and last activity. Use for \"Which projects are in DataRobot use case 65a1b2c3d4e5f6a7b8c9d002\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case_id":{"description":"ID of the use case, as returned by list_use_cases.","maxLength":200,"title":"Use Case Id","type":"string"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results to return (default 25, maximum 100).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only projects whose name matches this text.","title":"Search"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"-updatedAt","description":"Order of results, for example -updatedAt, name or -models (prefix - for descending).","title":"Order By"}},"required":["use_case_id"],"title":"list_use_case_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_use_case_datasets":{"post":{"operationId":"list_use_case_datasets","summary":"List the datasets attached to a use case with row and column counts, size and processing state. Use for \"Which datasets ","description":"List the datasets attached to a use case with row and column counts, size and processing state. Use for \"Which datasets are in DataRobot use case 65a1b2c3d4e5f6a7b8c9d002\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case_id":{"description":"ID of the use case, as returned by list_use_cases.","maxLength":200,"title":"Use Case Id","type":"string"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results to return (default 25, maximum 100).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only datasets whose name matches this text.","title":"Search"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"-createdAt","description":"Order of results, for example -createdAt, name or -datasetSize (prefix - for descending).","title":"Order By"}},"required":["use_case_id"],"title":"list_use_case_datasetsArguments","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_use_case_deployments":{"post":{"operationId":"list_use_case_deployments","summary":"List the deployments linked to a use case with label, type and last activity. Use for \"Which deployments belong to DataR","description":"List the deployments linked to a use case with label, type and last activity. Use for \"Which deployments belong to DataRobot use case 65a1b2c3d4e5f6a7b8c9d002\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case_id":{"description":"ID of the use case, as returned by list_use_cases.","maxLength":200,"title":"Use Case Id","type":"string"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results to return (default 25, maximum 100).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only deployments whose name matches this text.","title":"Search"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":"-createdAt","description":"Order of results, for example -createdAt, name or -lastActivity (prefix - for descending).","title":"Order By"}},"required":["use_case_id"],"title":"list_use_case_deploymentsArguments","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 classic modeling projects of the account with target, target type, source file and linked use case. Use for \"What D","description":"List classic modeling projects of the account with target, target type, source file and linked use case. Use for \"What DataRobot modeling projects do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip (default 0).","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many projects (default 25).","title":"Limit"},"project_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only projects whose name matches this text.","title":"Project Name"},"order_by":{"anyOf":[{"enum":["projectName","-projectName"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by projectName or -projectName.","title":"Order By"}},"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 modeling project: name, target, target type, source file, creation time and linked use case. Use for \"Show DataR","description":"Get one modeling project: name, target, target type, source file, creation time and linked use case. Use for \"Show DataRobot project 65a1b2c3d4e5f6a7b8c9d001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the modeling project, as returned by list_projects.","maxLength":200,"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_project_jobs":{"post":{"operationId":"list_project_jobs","summary":"List the running, queued or failed jobs of a modeling project with job type and status. Use for \"Which jobs are running ","description":"List the running, queued or failed jobs of a modeling project with job type and status. Use for \"Which jobs are running in DataRobot project 65a1b2c3d4e5f6a7b8c9d001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the modeling project, as returned by list_projects.","maxLength":200,"title":"Project Id","type":"string"},"status":{"anyOf":[{"enum":["queue","inprogress","error"],"type":"string"},{"type":"null"}],"default":null,"description":"Only jobs in this state: queue, inprogress or error.","title":"Status"}},"required":["project_id"],"title":"list_project_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_project_models":{"post":{"operationId":"list_project_models","summary":"List the leaderboard models of a project with model type, sample size, scores per metric and whether they are starred. U","description":"List the leaderboard models of a project with model type, sample size, scores per metric and whether they are starred. Use for \"Which models are on the leaderboard of DataRobot project 65a1b2c3d4e5f6a7b8c9d001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"ID of the modeling project, as returned by list_projects.","maxLength":200,"title":"Project Id","type":"string"},"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only models whose type name matches this text.","title":"Name"},"is_starred":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":null,"description":"Set to true to list only starred models.","title":"Is Starred"},"order_by":{"anyOf":[{"enum":["metric","-metric","samplePct","-samplePct"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by metric, -metric, samplePct or -samplePct.","title":"Order By"}},"required":["project_id"],"title":"list_project_modelsArguments","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_datasets":{"post":{"operationId":"list_datasets","summary":"List datasets in the data registry (latest versions) with row and column counts, size, categories and processing state. ","description":"List datasets in the data registry (latest versions) with row and column counts, size, categories and processing state. Use for \"What datasets are in my DataRobot data registry\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results (default 25).","title":"Limit"},"category":{"anyOf":[{"enum":["TRAINING","PREDICTION","SAMPLE"],"type":"string"},{"type":"null"}],"default":null,"description":"Only dataset versions with this category.","title":"Category"},"order_by":{"anyOf":[{"enum":["created","-created"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by created or -created.","title":"Order By"}},"title":"list_datasetsArguments","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_dataset":{"post":{"operationId":"get_dataset","summary":"Get one registry dataset: name, row and feature counts, size, processing state and modification dates. Use for \"Show Dat","description":"Get one registry dataset: name, row and feature counts, size, processing state and modification dates. Use for \"Show DataRobot dataset 65a1b2c3d4e5f6a7b8c9d003\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_id":{"description":"ID of the dataset in the data registry, as returned by list_datasets.","maxLength":200,"title":"Dataset Id","type":"string"}},"required":["dataset_id"],"title":"get_datasetArguments","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_dataset_versions":{"post":{"operationId":"list_dataset_versions","summary":"List the versions of a registry dataset with row counts, sizes and creation dates. Use for \"What versions does DataRobot","description":"List the versions of a registry dataset with row counts, sizes and creation dates. Use for \"What versions does DataRobot dataset 65a1b2c3d4e5f6a7b8c9d003 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"dataset_id":{"description":"ID of the dataset in the data registry, as returned by list_datasets.","maxLength":200,"title":"Dataset Id","type":"string"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many results to skip.","title":"Offset"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"At most this many results (default 25).","title":"Limit"},"order_by":{"anyOf":[{"enum":["created","-created"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by created or -created.","title":"Order By"}},"required":["dataset_id"],"title":"list_dataset_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}}}}