v1

latestOpenAPI 3.0.3MIT2026-07-17241338.5 KB

SecretGrants

Create a secret grant

Creates an AgentSecretGrant resource granting a specific agent access to a named secret with the specified permissions.

post/api/orgs/{org}/secret-grants

Path parameters

orgstring required

Example:default

Organization slug

Request body

namestring

Grant resource name (auto-generated if omitted)

secretNamestring required

Name of the secret to grant access to

grantedTostring required

Agent stack or system receiving the grant

permissionsstring[]

Example request

{
  "name": "grant-github-token",
  "secretName": "github-token",
  "grantedTo": "agent-stack-builder"
}

Response

Secret grant created

createdboolean

True if created, false if updated

namestring

Resource name

Example response

{
  "resource": {
    "apiVersion": "kradle.a5c.ai/v1alpha1",
    "kind": "AgentStack",
    "metadata": {
      "name": "my-stack",
      "namespace": "kradle-org-default"
    }
  }
}