FruxonDocs
ApiSecrets

Grants an agent permission to reference this secret.

Idempotent — granting an agent that already holds a grant returns the existing record. The grant authorizes the resolver to expand `{{secret.NAME}}` placeholders in tool arguments for that agent.

PUT
/v1/tenants/{tenant}/secrets/{secret}/grants/{grant}

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

secret*string

The secret identifier (Guid).

Formatuuid
grant*string

The agent identifier to grant access to.

tenant*string

The tenant identifier

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/secrets/497f6eca-6276-4993-bfeb-53cbbbba6f08/grants/string"
{
  "id": "00000000-0000-0000-0000-000000000000",
  "agentId": "string",
  "secretId": "00000000-0000-0000-0000-000000000000",
  "createdBy": "string",
  "createdAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}