Grant Workload Secret Access
grant_workload_secret_accessGrant an EXISTING workload access to a secret: ensures it has an identity and a policy binding with reveal, and redeploys it when it is waiting on the secret. remove true revokes it, keeping the identity. Use it rather than building the identity and policy by hand. Never returns values. For a NEW workload, create_workload first; its deployment pauses on the reference until access is granted, then resumes. A missing secret: create_secret first. Does not edit env or volumes: reference the secret there as cpln://secret/NAME.KEY.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"gvc": "<gvc>",
"workloadName": "<workloadName>",
"secretName": "<secretName>"
},
"name": "grant_workload_secret_access"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gvc | Yes | GVC name. | |
| org | No | Organization slug. | |
| remove | No | true takes the secret back out of the policy instead; the identity stays. | |
| policyName | No | Optional org-scoped policy resource name to create/use; pass the name only. Omit to default to {gvc}-{workloadName}-secrets-policy; another name adds a second policy for the same workload. | |
| secretName | Yes | Existing org-scoped secret name to grant access to; pass the name only, not cpln://secret/... or //secret/... . | |
| identityName | No | Optional identity resource name to create/use in this GVC; pass the name only. Omit to default to {gvc}-{workloadName}. | |
| workloadName | Yes | Existing workload name that should receive secret access; pass the name only, not a link. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | The full result. Read this, not only the summary. | |
| details | No | ||
| summary | Yes | ||
| nextSteps | No |