Documentation menu

Set secret binding

PUThttps://api.instacloud.com/projects/{projectId}/secret-bindings/{name}

Token scope: account · org · project — read-only tokens refused (not a GET).

Bind a provider-minted credential into a compute env var. Gated — secrets.write.

Parameters

Name	In	Type	Required	Description
`projectId`	path	`string`	yes
`name`	path	`string`	yes	^[A-Z][A-Z0-9_]{0,63}$

application/json

Field	Type	Required	Description
`branch`	`string`	no	Branch name (defaults to the project's default branch)
`target`	`string`	yes	target compute service ref: "compute/<name>"
`source`	`string`	yes	source service ref, e.g. "postgres/db"
`sourceName`	`string`	no	source credential name; optional only when the source exposes exactly one credential

Default Response

Field	Type	Required	Description
`ok`	`boolean`	no

Default Response

Field	Type	Required	Description
`status`	`"approval_required"`	no
`approvalId`	`string`	no
`action`	`string`	no	the gated action, or a comma-joined compound set — prefer `actions`
`actions`	`string[]`	no	every capability this approval covers
`message`	`string`	no
`url`	`string`	no	the console page where a project admin reviews this request
`nextActions`	`object[]`	no
`nextActions.op`	`string`	yes	Neutral logical action id, e.g. "service.add" — NOT an operationId or a CLI/MCP tool name; each client maps it to its own surface.
`nextActions.reason`	`string`	yes	Natural-language, human/LLM-facing "why do this now".
`nextActions.args`	`object`	no	Suggested, flat named arguments; "<placeholder>"s where a value is unknown.
`nextActions.gated`	`boolean`	no	True if the action passes a governance gate.

Default Response

Field	Type	Required	Description
`error`	`string`	yes

Default Response

Field	Type	Required	Description
`error`	`string`	yes

Default Response

Field	Type	Required	Description
`error`	`string`	yes

Default Response

Field	Type	Required	Description
`error`	`string`	yes