patch
https://{tenanturl}/v1.0/Agents/
Partially updates an agent using the SCIM 2.0 PATCH operation. Only the fields specified in the operations array are modified; all other fields remain unchanged.
Entitlements:
tenantAdmin— full access (all operations)agentOwner— full create, read, update, and delete access, and status changeswriteAgents— update metadata only; cannot change statusmanageAgentStatus— update status only; all other fields must match existing values
Supported Paths
displayName,description,status,tags,externalIds,owners
Note: displayName is mandatory and cannot be removed.
Examples
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"],
"Operations": [
{ "op": "replace", "path": "status", "value": "ACTIVE" },
{ "op": "add", "path": "tags", "value": ["production"] },
{ "op": "remove", "path": "description" }
]
}Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
204Agent patched successfully - No Content
400Bad Request - Invalid request payload (CSINH1002E), unknown operation path (CSINH2113E), or validation errors
401Unauthorized - Authentication required
403Forbidden - Insufficient permissions (CSINH2501E), unauthorized status change (CSINH2506E), or unauthorized field change (CSINH2507E)
404Not Found - Agent not found (CSINH2001E)
409Conflict - Agent with same displayName or externalId already exists (CSINH2002E)
500Internal Server Error (CSINH1000E)
