{"openapi":"3.1.0","info":{"title":"Venafi Cloud (other regions) (BYOK) API","version":"0.1.0","description":"Venafi Cloud (other regions) (BYOK) lets an AI assistant read your own Venafi Cloud (other regions) data through the Venafi Cloud (other regions) API with a key you supply (Venafi Cloud API key (from your user preferences)). Read-only: 12 tools (list_certificates, get_certificate, list_applications, get_application, list_issuing_templates, list_machines, list_machine_identities, list_satellites,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-venafi-cloud-regions.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-venafi-cloud-regions/docs"},"termsOfService":"https://connectorbay.com/byok-venafi-cloud-regions/terms"},"servers":[{"url":"https://byok-venafi-cloud-regions.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-venafi-cloud-regions/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_certificates":{"post":{"operationId":"list_certificates","summary":"List certificates in the inventory with names, subject, issuer, validity dates, key strength, status and tags. The subje","description":"List certificates in the inventory with names, subject, issuer, validity dates, key strength, status and tags. The subject filter is a regular expression. Use for \"Which certificates in Venafi expire soonest\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"subject":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Regular expression matched against the certificate subject, for example 'example\\.com'.","title":"Subject"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Maximum number of certificates (1 to 1000).","title":"Limit"}},"required":["region"],"title":"list_certificatesArguments","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_certificate":{"post":{"operationId":"get_certificate","summary":"Get one certificate by id: names, subject, issuer, validity, key and signature algorithm, status, tags and instance coun","description":"Get one certificate by id: names, subject, issuer, validity, key and signature algorithm, status, tags and instance counts. Use for \"What are the details of Venafi certificate c1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"certificate_id":{"description":"Certificate id (UUID from list_certificates).","maxLength":200,"title":"Certificate Id","type":"string"}},"required":["region","certificate_id"],"title":"get_certificateArguments","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_applications":{"post":{"operationId":"list_applications","summary":"List applications (groups of certificates for one purpose) with domains, IP ranges, ports and issuing template aliases. ","description":"List applications (groups of certificates for one purpose) with domains, IP ranges, ports and issuing template aliases. Use for \"Which applications are defined in Venafi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_applicationsArguments","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_application":{"post":{"operationId":"get_application","summary":"Get one application by id: description, domains, IP ranges, ports and issuing template aliases. Use for \"What is the Ven","description":"Get one application by id: description, domains, IP ranges, ports and issuing template aliases. Use for \"What is the Venafi application a1 for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"application_id":{"description":"Application id (UUID from list_applications).","maxLength":200,"title":"Application Id","type":"string"}},"required":["region","application_id"],"title":"get_applicationArguments","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_issuing_templates":{"post":{"operationId":"list_issuing_templates","summary":"List certificate issuing templates with certificate authority type, account id, priority and key reuse setting. Use for ","description":"List certificate issuing templates with certificate authority type, account id, priority and key reuse setting. Use for \"Which certificate issuing templates exist in Venafi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"},"certificate_authority":{"anyOf":[{"enum":["MOCKCA","DIGICERT","GLOBALSIGN","BUILTIN","ENTRUST","MICROSOFT","ACME","ZTPKI","GLOBALSIGNMSSL","TPP","CONNECTOR","BUILTIN_GEN2"],"type":"string"},{"type":"null"}],"default":null,"description":"Only templates of this CA type; omit for all.","title":"Certificate Authority"}},"required":["region"],"title":"list_issuing_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/list_machines":{"post":{"operationId":"list_machines","summary":"List machines (targets that receive certificates) with type, status, integration, discovery and provisioning state. Use ","description":"List machines (targets that receive certificates) with type, status, integration, discovery and provisioning state. Use for \"Which machines does Venafi manage certificates for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_machinesArguments","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_machine_identities":{"post":{"operationId":"list_machine_identities","summary":"List machine identities (certificate bindings on machines) with certificate id, machine id, validation status and last s","description":"List machine identities (certificate bindings on machines) with certificate id, machine id, validation status and last seen time. Use for \"Which machine identities in Venafi failed validation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_machine_identitiesArguments","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_satellites":{"post":{"operationId":"list_satellites","summary":"List satellite (edge) instances with status, type, version, last seen time and upgrade status. Use for \"Are my Venafi sa","description":"List satellite (edge) instances with status, type, version, last seen time and upgrade status. Use for \"Are my Venafi satellites online and up to date\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_satellitesArguments","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_teams":{"post":{"operationId":"list_teams","summary":"List teams of the company with id, name and last modification (members are not returned). Use for \"Which teams exist in ","description":"List teams of the company with id, name and last modification (members are not returned). Use for \"Which teams exist in Venafi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_teamsArguments","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_tags":{"post":{"operationId":"list_tags","summary":"List the tags available for labelling certificates and other entities. Use for \"Which tags are available in Venafi\".","description":"List the tags available for labelling certificates and other entities. Use for \"Which tags are available in Venafi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_tagsArguments","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_certificate_requests":{"post":{"operationId":"list_certificate_requests","summary":"List certificate requests with status, application, issuing template, key type and size, subject and dates. Use for \"Wha","description":"List certificate requests with status, application, issuing template, key type and size, subject and dates. Use for \"What certificate requests are pending in Venafi\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"list_certificate_requestsArguments","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_autorenewal_status":{"post":{"operationId":"get_autorenewal_status","summary":"Show the state of the automatic certificate renewal monitoring: current and previous run with state, time and applicatio","description":"Show the state of the automatic certificate renewal monitoring: current and previous run with state, time and application count. Use for \"Is Venafi automatic certificate renewal running\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region":{"description":"Region code of your tenant: eu, au, uk, sg or ca (the US region is a separate connector).","maxLength":200,"pattern":"^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$","title":"Region","type":"string"}},"required":["region"],"title":"get_autorenewal_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}}}}