Connections

Target-owned logical connection bindings, explicit credential refreshes, and redacted health.

Operations

Each operation lists its specific responses. See Common error responses for errors shared by every operation on this page.

List target connection bindings

GET /api/v1/projects/{project}/targets/{target}/connection-bindings

Operation ID: listTargetConnectionBindings
Effect: read
Confirmation: never
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Create a target connection binding

POST /api/v1/projects/{project}/targets/{target}/connection-bindings

Operation ID: createTargetConnectionBinding
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Get target connection binding metadata

GET /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}

Operation ID: getTargetConnectionBinding
Effect: read
Confirmation: never
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Update target connection binding metadata

PUT /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}

Operation ID: updateTargetConnectionBinding
Effect: idempotent-write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Disable a target connection binding

POST /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}/disable

Operation ID: disableTargetConnectionBinding
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Enable a target connection binding

POST /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}/enable

Operation ID: enableTargetConnectionBinding
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Get redacted target connection runtime health

GET /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}/health

Operation ID: getTargetConnectionBindingHealth
Effect: read
Confirmation: never
Required privilege: RESOURCE_READ
Focused reference: JSON · Markdown

Parameters

Responses

Plan a dependency-aware target connection change

POST /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}/plan

Query classification: computes dependencies and a confirmation token without mutating durable binding or runtime state.

Operation ID: planTargetConnectionBindingChange
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Refresh credentials and replace the validated target pool

POST /api/v1/projects/{project}/targets/{target}/connection-bindings/{connection}/refresh

Operation ID: refreshTargetConnectionBinding
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Read the local runtime's retained development profile application

GET /api/v1/projects/{project}/targets/{target}/development-profile-application

Operation ID: getDevelopmentProfileApplication
Effect: read
Confirmation: never
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Responses

Apply an exact development profile to the local runtime

POST /api/v1/projects/{project}/targets/{target}/development-profile-application

Operation ID: applyDevelopmentProfile
Effect: write
Confirmation: conditional
Required privilege: RESOURCE_MANAGE
Focused reference: JSON · Markdown

Parameters

Request body

Content types: application/json.

Responses

Common error responses

These error responses apply to every operation on this page.