Overview
PUT/access/personas/{id}/user-toolsregistry

Replace the caller's allowed-tool set for this persona (all-on / all-off / per-tool)

Replace a record in user-tools by id.

Auth: bearerAuth — calls run as the authenticated user.

Parameters
  • idpathstring
Request body

application/json · optional

  • allowedstring[]

    the tools the caller allows the persona to invoke for them; every name must be one of the persona's owner-granted tools (400 otherwise). [] clears; all names = all-on.

Example
{
  "allowed": [
    "string"
  ]
}
Responses
200

the updated per-user tool view

  • toolsRegistryPersonaUserTool[]
Example
{
  "tools": [
    {
      "toolName": "string",
      "source": "string",
      "displayName": "string",
      "description": "string",
      "readOnly": true,
      "allowed": true
    }
  ]
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
404

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X PUT "https://api.agenticdeveloperhub.com/access/personas/{id}/user-tools" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "allowed": [
    "string"
  ]
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/access/personas/{id}/user-tools", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"allowed\": [\n    \"string\"\n  ]\n}",
});
const data = await res.json();