{"openapi":"3.1.0","info":{"title":"IONOS Certificate Manager (BYOK) API","version":"0.1.0","description":"IONOS Certificate Manager (BYOK) lets an AI assistant read your own IONOS Certificate Manager data through the IONOS Certificate Manager API with a key you supply (IONOS Cloud API token (JWT)). Read-only: 5 tools (list_certificates, get_certificate, list_auto_certificates, get_auto_certificate, list_acme_providers). The BYOK key travels with each request, is used for that one call only and is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-ionos-certificates.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-ionos-certificates/docs"},"termsOfService":"https://connectorbay.com/byok-ionos-certificates/terms"},"servers":[{"url":"https://byok-ionos-certificates.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-ionos-certificates/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 TLS certificates with name, common name, alternative names, validity dates, expired flag and serial number. Certifi","description":"List TLS certificates with name, common name, alternative names, validity dates, expired flag and serial number. Certificate bodies and private keys are never returned. Use for \"Which of my IONOS certificates are about to expire\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"common_name":{"anyOf":[{"maxLength":253,"type":"string"},{"type":"null"}],"default":null,"description":"Only certificates with this common name (DNS name).","title":"Common Name"},"auto_certificate":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only certificates issued by this automatic certificate id.","title":"Auto Certificate"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip from the start of the list.","title":"Offset"}},"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: name, state, common name, alternative names, validity dates and serial number. The certificate body","description":"Get one certificate: name, state, common name, alternative names, validity dates and serial number. The certificate body and private key are left out. Use for \"Show IONOS certificate c1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"certificate_id":{"description":"Certificate id (a UUID) from list_certificates.","maxLength":64,"title":"Certificate Id","type":"string"}},"required":["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_auto_certificates":{"post":{"operationId":"list_auto_certificates","summary":"List automatic (ACME) certificate orders with name, provider, common name, key algorithm and last issued certificate. Us","description":"List automatic (ACME) certificate orders with name, provider, common name, key algorithm and last issued certificate. Use for \"Which automatic certificates does IONOS renew for me\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"common_name":{"anyOf":[{"maxLength":253,"type":"string"},{"type":"null"}],"default":null,"description":"Only orders with this common name (DNS name).","title":"Common Name"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip from the start of the list.","title":"Offset"}},"title":"list_auto_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_auto_certificate":{"post":{"operationId":"get_auto_certificate","summary":"Get one automatic certificate order: state, provider, common name, key algorithm, alternative names and last issued cert","description":"Get one automatic certificate order: state, provider, common name, key algorithm, alternative names and last issued certificate. Use for \"Show IONOS automatic certificate a1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"auto_certificate_id":{"description":"Automatic certificate id (a UUID) from list_auto_certificates.","maxLength":64,"title":"Auto Certificate Id","type":"string"}},"required":["auto_certificate_id"],"title":"get_auto_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_acme_providers":{"post":{"operationId":"list_acme_providers","summary":"List the ACME certificate providers configured for the account with name, server URL and state. Account binding secrets ","description":"List the ACME certificate providers configured for the account with name, server URL and state. Account binding secrets are never returned. Use for \"Which ACME providers are set up for IONOS certificates\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"How many items to return.","title":"Limit"},"offset":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"How many items to skip from the start of the list.","title":"Offset"}},"title":"list_acme_providersArguments","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}}}}