{"openapi":"3.1.0","info":{"title":"Confident AI Prompts (BYOK) API","version":"0.1.0","description":"Confident AI Prompts (BYOK) lets an AI assistant read your own Confident AI Prompts data through the Confident AI Prompts API with a key you supply (Confident AI project API key). Read-only: 6 tools (list_prompts, list_prompt_versions, list_prompt_branches, list_prompt_commits, list_tools, list_tool_versions). The BYOK key travels with each request, is used for that one call only and is never...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-confident-ai-prompts.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-confident-ai-prompts/docs"},"termsOfService":"https://connectorbay.com/byok-confident-ai-prompts/terms"},"servers":[{"url":"https://byok-confident-ai-prompts.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-confident-ai-prompts/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_prompts":{"post":{"operationId":"list_prompts","summary":"List the prompts of the project with id, alias and type (TEXT or LIST of messages). Use for \"Which prompts are managed i","description":"List the prompts of the project with id, alias and type (TEXT or LIST of messages). Use for \"Which prompts are managed in my Confident AI project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_promptsArguments","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_versions":{"post":{"operationId":"list_prompt_versions","summary":"List every released version of a prompt, oldest first, with version label, plus the prompt type. Use for \"What versions ","description":"List every released version of a prompt, oldest first, with version label, plus the prompt type. Use for \"What versions of the Confident AI prompt prm_123 have been released\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"prompt_id":{"description":"Prompt id, as returned by list_prompts.","maxLength":200,"title":"Prompt Id","type":"string"}},"required":["prompt_id"],"title":"list_prompt_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/list_prompt_branches":{"post":{"operationId":"list_prompt_branches","summary":"List the branches of a prompt (id and name). Use for \"Which branches does the Confident AI prompt prm_123 have\".","description":"List the branches of a prompt (id and name). Use for \"Which branches does the Confident AI prompt prm_123 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"prompt_id":{"description":"Prompt id, as returned by list_prompts.","maxLength":200,"title":"Prompt Id","type":"string"}},"required":["prompt_id"],"title":"list_prompt_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/list_prompt_commits":{"post":{"operationId":"list_prompt_commits","summary":"List the commits of a prompt, newest first, with id, hash and commit message, optionally for one branch. Use for \"Show t","description":"List the commits of a prompt, newest first, with id, hash and commit message, optionally for one branch. Use for \"Show the recent commits of the Confident AI prompt prm_123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"prompt_id":{"description":"Prompt id, as returned by list_prompts.","maxLength":200,"title":"Prompt Id","type":"string"},"branch":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Branch name to read from (default main).","title":"Branch"}},"required":["prompt_id"],"title":"list_prompt_commitsArguments","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_tools":{"post":{"operationId":"list_tools","summary":"List the agent tools registered in the project (id, name, latest version), newest first, one page at a time. Use for \"Wh","description":"List the agent tools registered in the project (id, name, latest version), newest first, one page at a time. Use for \"Which tools are registered in my Confident AI project\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":100000,"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":25,"description":"How many tools per page (1 to 100).","title":"Page Size"},"search_term":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only tools whose name contains this text.","title":"Search Term"}},"title":"list_toolsArguments","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_tool_versions":{"post":{"operationId":"list_tool_versions","summary":"List the versions of one tool, newest first, with mode, input JSON schema and creation time. Use for \"What versions does","description":"List the versions of one tool, newest first, with mode, input JSON schema and creation time. Use for \"What versions does the Confident AI tool tool_1 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tool_id":{"description":"Tool id, as returned by list_tools.","maxLength":200,"title":"Tool Id","type":"string"},"page":{"anyOf":[{"maximum":100000,"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":25,"description":"How many versions per page (1 to 100).","title":"Page Size"}},"required":["tool_id"],"title":"list_tool_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}}}}