Infisical PKI Discovery API
The PKI Discovery API from Infisical — 6 operation(s) for pki discovery.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/infisical-pki-discovery-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Infisical Admin PKI Discovery API
description: List of all available APIs that can be consumed
version: 0.0.1
servers:
- url: https://us.infisical.com
description: Production server (US)
- url: https://eu.infisical.com
description: Production server (EU)
- url: http://localhost:8080
description: Local server
tags:
- name: PKI Discovery
paths:
/api/v1/cert-manager/discovery-jobs/config:
get:
operationId: getPkiDiscoveryConfig
tags:
- PKI Discovery
description: Get PKI discovery configuration limits and defaults
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
defaultPorts:
type: string
maxPorts:
type: number
maxIps:
type: number
maxDomains:
type: number
minCidrPrefix:
type: number
required:
- defaultPorts
- maxPorts
- maxIps
- maxDomains
- minCidrPrefix
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 400
message:
type: string
error:
type: string
details: {}
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 401
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 403
message:
type: string
details: {}
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 404
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'422':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 422
message: {}
error:
type: string
required:
- reqId
- statusCode
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 500
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
/api/v1/cert-manager/discovery-jobs:
post:
operationId: createPkiDiscovery
tags:
- PKI Discovery
description: Create a new PKI discovery configuration
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 100
description: Name of the discovery configuration
description:
type: string
maxLength: 500
description: Description of the discovery configuration
discoveryType:
type: string
enum:
- network
default: network
description: Type of discovery scan
targetConfig:
type: object
properties:
ipRanges:
type: array
items:
type: string
maxLength: 64
domains:
type: array
items:
type: string
maxLength: 253
ports:
type: string
default: 443, 8443, 636, 993, 995
additionalProperties: false
description: Target configuration for discovery scans
isAutoScanEnabled:
type: boolean
default: false
description: Enable automatic scheduled scans
scanIntervalDays:
type: number
minimum: 1
maximum: 365
description: Interval in days between automatic scans
gatewayId:
type: string
format: uuid
description: Gateway ID for scanning private networks
gatewayPoolId:
type: string
format: uuid
description: Gateway pool ID for scanning private networks
required:
- name
- targetConfig
additionalProperties: false
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
discoveryType:
type: string
default: network
targetConfig: {}
isAutoScanEnabled:
type: boolean
default: false
scanIntervalDays:
type:
- number
- 'null'
gatewayId:
type:
- string
- 'null'
format: uuid
isActive:
type: boolean
default: true
lastScanStatus:
type:
- string
- 'null'
lastScanJobId:
type:
- string
- 'null'
lastScanMessage:
type:
- string
- 'null'
lastScannedAt:
type:
- string
- 'null'
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
gatewayPoolId:
type:
- string
- 'null'
format: uuid
required:
- id
- name
- createdAt
- updatedAt
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 400
message:
type: string
error:
type: string
details: {}
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 401
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 403
message:
type: string
details: {}
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 404
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'422':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 422
message: {}
error:
type: string
required:
- reqId
- statusCode
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 500
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
get:
operationId: listPkiDiscoveries
tags:
- PKI Discovery
description: List PKI discovery configurations for a project
parameters:
- schema:
type: number
minimum: 0
default: 0
in: query
name: offset
required: false
description: Pagination offset
- schema:
type: number
minimum: 1
maximum: 100
default: 25
in: query
name: limit
required: false
description: Pagination limit
- schema:
type: string
in: query
name: search
required: false
description: Search filter for name or description
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
discoveries:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
discoveryType:
type: string
default: network
targetConfig: {}
isAutoScanEnabled:
type: boolean
default: false
scanIntervalDays:
type:
- number
- 'null'
gatewayId:
type:
- string
- 'null'
format: uuid
isActive:
type: boolean
default: true
lastScanStatus:
type:
- string
- 'null'
lastScanJobId:
type:
- string
- 'null'
lastScanMessage:
type:
- string
- 'null'
lastScannedAt:
type:
- string
- 'null'
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
gatewayPoolId:
type:
- string
- 'null'
format: uuid
certificatesFound:
type: number
installationsFound:
type: number
required:
- id
- name
- createdAt
- updatedAt
- certificatesFound
- installationsFound
additionalProperties: false
totalCount:
type: number
required:
- discoveries
- totalCount
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 400
message:
type: string
error:
type: string
details: {}
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 401
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 403
message:
type: string
details: {}
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 404
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'422':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 422
message: {}
error:
type: string
required:
- reqId
- statusCode
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 500
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
/api/v1/cert-manager/discovery-jobs/{discoveryId}:
get:
operationId: getPkiDiscovery
tags:
- PKI Discovery
description: Get a PKI discovery configuration by ID
parameters:
- schema:
type: string
format: uuid
in: path
name: discoveryId
required: true
description: The ID of the discovery configuration
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
discoveryType:
type: string
default: network
targetConfig: {}
isAutoScanEnabled:
type: boolean
default: false
scanIntervalDays:
type:
- number
- 'null'
gatewayId:
type:
- string
- 'null'
format: uuid
isActive:
type: boolean
default: true
lastScanStatus:
type:
- string
- 'null'
lastScanJobId:
type:
- string
- 'null'
lastScanMessage:
type:
- string
- 'null'
lastScannedAt:
type:
- string
- 'null'
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
gatewayPoolId:
type:
- string
- 'null'
format: uuid
linkedInstallationsCount:
type: number
gatewayName:
type:
- string
- 'null'
gatewayPoolName:
type:
- string
- 'null'
required:
- id
- name
- createdAt
- updatedAt
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 400
message:
type: string
error:
type: string
details: {}
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'401':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 401
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'403':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 403
message:
type: string
details: {}
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'404':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 404
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
'422':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 422
message: {}
error:
type: string
required:
- reqId
- statusCode
- error
additionalProperties: false
'500':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
type: string
statusCode:
type: number
enum:
- 500
message:
type: string
error:
type: string
required:
- reqId
- statusCode
- message
- error
additionalProperties: false
patch:
operationId: updatePkiDiscovery
tags:
- PKI Discovery
description: Update a PKI discovery configuration
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
maxLength: 100
description: Name of the discovery configuration
description:
type:
- string
- 'null'
maxLength: 500
description: Description of the discovery configuration
targetConfig:
type: object
properties:
ipRanges:
type: array
items:
type: string
maxLength: 64
domains:
type: array
items:
type: string
maxLength: 253
ports:
type: string
default: 443, 8443, 636, 993, 995
additionalProperties: false
description: Target configuration for discovery scans
isAutoScanEnabled:
type: boolean
description: Enable automatic scheduled scans
scanIntervalDays:
type:
- number
- 'null'
minimum: 1
maximum: 365
description: Interval in days between automatic scans
gatewayId:
type:
- string
- 'null'
format: uuid
description: Gateway ID for scanning private networks
gatewayPoolId:
type:
- string
- 'null'
format: uuid
description: Gateway pool ID for scanning private networks
isActive:
type: boolean
description: Whether the discovery configuration is active
additionalProperties: false
parameters:
- schema:
type: string
format: uuid
in: path
name: discoveryId
required: true
description: The ID of the discovery configuration
responses:
'200':
description: Default Response
content:
application/json:
schema:
type: object
properties:
id:
type: string
format: uuid
name:
type: string
description:
type:
- string
- 'null'
discoveryType:
type: string
default: network
targetConfig: {}
isAutoScanEnabled:
type: boolean
default: false
scanIntervalDays:
type:
- number
- 'null'
gatewayId:
type:
- string
- 'null'
format: uuid
isActive:
type: boolean
default: true
lastScanStatus:
type:
- string
- 'null'
lastScanJobId:
type:
- string
- 'null'
lastScanMessage:
type:
- string
- 'null'
lastScannedAt:
type:
- string
- 'null'
format: date-time
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
gatewayPoolId:
type:
- string
- 'null'
format: uuid
required:
- id
- name
- createdAt
- updatedAt
additionalProperties: false
'400':
description: Default Response
content:
application/json:
schema:
type: object
properties:
reqId:
# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/infisical/refs/heads/main/openapi/infisical-pki-discovery-api-openapi.yml