Updates the tool configuration of a PolarClaw Agent.
Try it now
Test
RAM authorization
Request syntax
POST HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ApplicationId |
string |
Yes |
The application ID. |
pa-xxx |
| AgentId |
string |
Yes |
Agent ID |
work |
| Profile |
string |
No |
The tool profile. |
coding |
| Allow |
array |
No |
The list of explicitly allowed tools. |
["read","write","exec"] |
|
string |
No |
The explicitly allowed tool. |
read |
|
| AlsoAllow |
array |
No |
The list of additionally allowed tools. |
["send_message"] |
|
string |
No |
The additionally allowed tool. |
send_message |
|
| Deny |
array |
No |
The list of denied tools. |
["exec"] |
|
string |
No |
The denied tool. |
exec |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
F45FFACC-xxx |
| Message |
string |
The response message. |
success |
| Code |
integer |
The status code. |
200 |
| ApplicationId |
string |
The application ID. |
pa-xxx |
| Ok |
boolean |
Indicates whether the operation was successful. |
true |
| AgentId |
string |
Agent ID |
work |
| Tools |
object |
The updated tool configuration. |
|
| Profile |
string |
The tool profile. |
coding |
| Allow |
array |
The list of explicitly allowed tools. |
|
|
string |
The tool identifier. |
read |
|
| AlsoAllow |
array |
The list of additionally allowed tools. |
|
|
string |
The tool identifier. |
send_message |
|
| Deny |
array |
The list of denied tools. |
|
|
string |
The tool identifier. |
exec |
Examples
Success response
JSON format
{
"RequestId": "F45FFACC-xxx",
"Message": "success",
"Code": 200,
"ApplicationId": "pa-xxx",
"Ok": true,
"AgentId": "work",
"Tools": {
"Profile": "coding",
"Allow": [
"read"
],
"AlsoAllow": [
"send_message"
],
"Deny": [
"exec"
]
}
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.