Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-17241338.5 KB
Secrets

Create a secret

Creates an AgentSecretGrant resource that registers a secret reference with the specified permissions and grant target.

post/api/orgs/{org}/secrets

Path parameters

orgstring required
Example:default

Organization slug

Request body

namestring required

Secret name

grantedTostring

Agent or system the secret is granted to

permissionsstring[]
dataobject

Optional secret data (key-value pairs)

Example request

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

Response

Secret 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"
    }
  }
}