Secrets

Encrypted values for agent sandboxes — names and metadata only; values are never returned.

GET/secretsList secret names and metadata (values are never returned)
POST/secretsCreate a secret for agent sandboxes
PATCH/secrets/{id}Rotate a secret’s value or change its description / agent access
DELETE/secrets/{id}Delete a secret

List secret names and metadata (values are never returned)

GET/secrets

Scope secrets:viewRead-only

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X GET "https://api.klerc.co/api/v1/secrets" \  -H "Authorization: Bearer $KLERC_TOKEN"

Create a secret for agent sandboxes

POST/secrets

Scope secrets:manageWrites data

Request body

Field	Type
`name`required	string
`value`required	string
`description`	string
`access`	object
`access.mode`	"all" \| "selected"
`access.agents`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X POST "https://api.klerc.co/api/v1/secrets" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"name":"…","value":"…","description":"…","access":{"mode":"all","agents":["…"]}}'

Rotate a secret’s value or change its description / agent access

PATCH/secrets/{id}

Scope secrets:manageWrites data

Path parameters

Name	Type
`id`required	string

Request body

Field	Type
`value`	string
`description`	string
`access`	object
`access.mode`	"all" \| "selected"
`access.agents`	array of string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X PATCH "https://api.klerc.co/api/v1/secrets/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN" \  -H "Content-Type: application/json" \  -d '{"value":"…","description":"…","access":{"mode":"all","agents":["…"]}}'

Delete a secret

DELETE/secrets/{id}

Scope secrets:manageWrites data

Path parameters

Name	Type
`id`required	string

Responses

200OK
201Created
401Authentication failed
403Insufficient scope / feature disabled
404Not found

curl

curl -X DELETE "https://api.klerc.co/api/v1/secrets/{id}" \  -H "Authorization: Bearer $KLERC_TOKEN"