Integrations API Reference

Field	Value
Source spec	`integrations/openapi/v1.json`
OpenAPI version	`3.1.1`
API version	`1.0.0`
Operations	29
Path filter	All paths

Operations

`GET /api/v1/buildinfo`

API alias for /buildinfo.json (same payload).

Property	Value
Operation ID	`StellaOpsBuildInfoApi`
Tags	`StellaOps.Integrations.WebService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations`

integrations.integration.list_description

Property	Value
Operation ID	`ListIntegrations`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required
`page`	`query`	no
`pageSize`	`query`	no
`provider`	`query`	no
`search`	`query`	no
`sortBy`	`query`	no
`sortDescending`	`query`	no
`status`	`query`	no
`type`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/problem+json`

`POST /api/v1/integrations`

integrations.integration.create_description

Property	Value
Operation ID	`CreateIntegration`
Tags	`Integrations`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`200`	OK	-

`POST /api/v1/integrations/ai-code-guard/run`

integrations.ai_code_guard.run_description

Property	Value
Operation ID	`RunAiCodeGuard`
Tags	`Integrations`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/providers`

integrations.integration.get_providers_description

Property	Value
Operation ID	`GetSupportedProviders`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`includeTestOnly`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/registries`

List aggregate registry image discovery posture for the current tenant.

Property	Value
Operation ID	`ListRegistryPosture`
Tags	`Registry Browse`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/registries/{id}/images`

List tenant-scoped image discovery rows for a registry integration.

Property	Value
Operation ID	`ListRegistryImages`
Tags	`Registry Browse`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required
`id`	`path`	yes
`afterId`	`query`	no
`pageSize`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/{id}`

integrations.integration.get_description

Property	Value
Operation ID	`GetIntegration`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`PUT /api/v1/integrations/{id}`

integrations.integration.update_description

Property	Value
Operation ID	`UpdateIntegration`
Tags	`Integrations`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`DELETE /api/v1/integrations/{id}`

integrations.integration.delete_description

Property	Value
Operation ID	`DeleteIntegration`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`PUT /api/v1/integrations/{id}/auto-scan`

Toggle the per-registry auto-scan-on-push opt-in (ExtendedConfig.autoScanOnConnect) without clobbering other config.

Property	Value
Operation ID	`SetIntegrationAutoScan`
Tags	`Integrations`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`POST /api/v1/integrations/{id}/discover`

Discover resources exposed by the integration provider.

Property	Value
Operation ID	`DiscoverIntegrationResources`
Tags	`Integrations`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/{id}/health`

integrations.integration.health_description

Property	Value
Operation ID	`CheckIntegrationHealth`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/integrations/{id}/impact`

integrations.integration.impact_description

Property	Value
Operation ID	`GetIntegrationImpact`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`POST /api/v1/integrations/{id}/resolve-credentials`

Resolve the credential for an integration (always AEAD-sealed; no plaintext egress). Trusted in-cluster only.

Property	Value
Operation ID	`ResolveIntegrationCredentials`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`POST /api/v1/integrations/{id}/test`

integrations.integration.test_description

Property	Value
Operation ID	`TestIntegrationConnection`
Tags	`Integrations`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`id`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`PUT /api/v1/secret-authority/bundles/{bundleId}`

Write or update a credential bundle in the selected secret authority and return authref bindings.

Property	Value
Operation ID	`UpsertSecretAuthorityBundle`
Tags	`Secret Authority`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`bundleId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/secret-authority/targets`

List tenant-visible secrets-manager integrations that can stage authref-backed credential bundles.

Property	Value
Operation ID	`ListSecretAuthorityTargets`
Tags	`Secret Authority`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/secret-authority/targets/{targetIntegrationId}/refs`

List the secret references available within a Vault secret-authority target (metadata only; no secret values).

Property	Value
Operation ID	`ListSecretAuthorityRefs`
Tags	`Secret Authority`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`targetIntegrationId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`GET /buildinfo.json`

Image build provenance (module, gitSha, gitCommitTime, imageBuiltAt, branch) for drift detection.

Property	Value
Operation ID	`StellaOpsBuildInfoFile`
Tags	`StellaOps.Integrations.WebService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /health`

Returns the liveness status and current UTC timestamp for the Integration Catalog service. Used by the Router gateway and container orchestrator for health polling.

Property	Value
Operation ID	`HealthCheck`
Tags	`Health`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /health/liveness`

Property	Value
Operation ID	`HealthLiveness`
Tags	`Health`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /health/readiness`

Property	Value
Operation ID	`HealthReadiness`
Tags	`Health`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /internal/crypto/populations`

Property	Value
Operation ID	`InternalGetCryptoPopulations`
Tags	`InternalCrypto`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`kekId`	`query`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`POST /internal/crypto/reseal/start`

Property	Value
Operation ID	`InternalStartCryptoReSeal`
Tags	`InternalCrypto`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`200`	OK	-

`POST /internal/crypto/reseal/{rotationId}/abort`

Property	Value
Operation ID	`InternalAbortCryptoReSeal`
Tags	`InternalCrypto`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`rotationId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`GET /internal/crypto/reseal/{rotationId}/progress`

Property	Value
Operation ID	`InternalGetCryptoReSealProgress`
Tags	`InternalCrypto`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`rotationId`	`path`	yes

Responses:

Status	Description	Content types
`200`	OK	-

`POST /internal/plugins/probe`

Property	Value
Operation ID	`IntegrationsPluginProbe`
Tags	`Internal`, `Plugins`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`200`	OK	-

`GET /internal/plugins/status`

Property	Value
Operation ID	`IntegrationsPluginStatus`
Tags	`Internal`, `Plugins`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-