Skip to main content
POST
/
agent
Service policies
curl --request POST \
  --url https://api.example.com/agent \
  --header 'Content-Type: application/json' \
  --data '
{
  "read_permission": "<string>",
  "write_permission": "<string>"
}
'

​
Get policies

{
  "action": "get-policies",
  "agent_id": "uuid"
}

​
Response

[
  {
    "service_name": "gmail",
    "service_display_name": "Gmail",
    "service_icon": "📧",
    "read_permission": "allowed",
    "write_permission": "human_approval",
    "auto_discovered": true
  },
  {
    "service_name": "system",
    "service_display_name": "System Tools",
    "service_icon": "🖥️",
    "read_permission": "allowed",
    "write_permission": "allowed",
    "auto_discovered": false
  }
]

​
Update policy

{
  "action": "update-policy",
  "agent_id": "uuid",
  "service_name": "gmail",
  "read_permission": "allowed",
  "write_permission": "human_approval"
}
​
read_permission
string
required
One of: allowed, blocked.
​
write_permission
string
required
One of: allowed, blocked, human_approval.

​
Response

{
  "success": true,
  "service_name": "gmail",
  "read_permission": "allowed",
  "write_permission": "human_approval"
}
Policy changes are pushed to the agent via Supabase Realtime within seconds. No agent restart needed.