{"openapi":"3.1.0","info":{"title":"Datarobot Generative AI (BYOK) API","version":"0.1.0","description":"Datarobot Generative AI (BYOK) lets an AI assistant read your own Datarobot Generative AI data through the Datarobot Generative AI API with a key you supply (DataRobot API key (US cloud, app.datarobot.com)). Read-only: 7 tools (list_llms, list_playgrounds, list_llm_blueprints, list_vector_databases, get_vector_database, list_prompt_templates, get_llm_api_call_counter). 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-datarobot-genai.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-datarobot-genai/docs"},"termsOfService":"https://connectorbay.com/byok-datarobot-genai/terms"},"servers":[{"url":"https://byok-datarobot-genai.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-datarobot-genai/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_llms":{"post":{"operationId":"list_llms","summary":"List the large language models available in DataRobot GenAI with vendor, provider, context size and whether each is acti","description":"List the large language models available in DataRobot GenAI with vendor, provider, context size and whether each is active or deprecated. US cloud only. Use for \"Which LLMs can I use in DataRobot\".","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 (default 25).","title":"Limit"},"active_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include only active models.","title":"Active Only"},"chat_completions_supported_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include only models that support chat completions.","title":"Chat Completions Supported Only"}},"title":"list_llmsArguments","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_playgrounds":{"post":{"operationId":"list_playgrounds","summary":"List GenAI playgrounds (workspaces where LLM blueprints are built and compared) with blueprint counts and use case. Use ","description":"List GenAI playgrounds (workspaces where LLM blueprints are built and compared) with blueprint counts and use case. Use for \"Which DataRobot GenAI playgrounds 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 (default 25).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only playgrounds whose name matches this text.","title":"Search"},"use_case_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only playgrounds linked to this use case ID.","title":"Use Case Id"}},"title":"list_playgroundsArguments","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_llm_blueprints":{"post":{"operationId":"list_llm_blueprints","summary":"List LLM blueprints (an LLM plus settings and an optional vector database) with their saved and starred state, filterabl","description":"List LLM blueprints (an LLM plus settings and an optional vector database) with their saved and starred state, filterable by playground. Use for \"Which LLM blueprints are in DataRobot playground 65a1b2c3d4e5f6a7b8c9d012\".","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 (default 25).","title":"Limit"},"playground_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only blueprints of this playground.","title":"Playground Id"},"is_saved":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for saved blueprints only, false for drafts only.","title":"Is Saved"},"is_starred":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only starred blueprints.","title":"Is Starred"}},"title":"list_llm_blueprintsArguments","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_vector_databases":{"post":{"operationId":"list_vector_databases","summary":"List vector databases built from datasets for retrieval with build status, chunk count, size and linked playgrounds. Use","description":"List vector databases built from datasets for retrieval with build status, chunk count, size and linked playgrounds. Use for \"Which vector databases do I have in DataRobot and did they finish building\".","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 (default 25).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only vector databases whose name matches this text.","title":"Search"},"use_case_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only vector databases linked to this use case ID.","title":"Use Case Id"},"completed_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to list only vector databases that finished building.","title":"Completed Only"}},"title":"list_vector_databasesArguments","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_vector_database":{"post":{"operationId":"get_vector_database","summary":"Get one vector database: build status, dataset, chunk count, size, embedding model and chunking settings. Use for \"Show ","description":"Get one vector database: build status, dataset, chunk count, size, embedding model and chunking settings. Use for \"Show DataRobot vector database 65a1b2c3d4e5f6a7b8c9d010\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"vector_database_id":{"description":"ID of the vector database, as returned by list_vector_databases.","maxLength":200,"title":"Vector Database Id","type":"string"}},"required":["vector_database_id"],"title":"get_vector_databaseArguments","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_prompt_templates":{"post":{"operationId":"list_prompt_templates","summary":"List prompt templates with description, version count and last update. Use for \"Which prompt templates exist in DataRobo","description":"List prompt templates with description, version count and last update. Use for \"Which prompt templates exist in DataRobot\".","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 (default 25).","title":"Limit"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only templates whose name matches this text.","title":"Search"}},"title":"list_prompt_templatesArguments","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_llm_api_call_counter":{"post":{"operationId":"get_llm_api_call_counter","summary":"Show how many LLM API calls the account has used against its GenAI limit counter. Use for \"How many DataRobot LLM API ca","description":"Show how many LLM API calls the account has used against its GenAI limit counter. Use for \"How many DataRobot LLM API calls have I used\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_llm_api_call_counterArguments","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}}}}