This collection provides details on the supported methods for the Lifecycle Management (LCM) API for AI agent governance, including agent search, label management, multi-owner assignment, and automated ownership succession.
\nThe URL for Identity Security for AI APIs is in the following format:
\n{{url}}/{{path}}/apiName
Where:
\n{{url}}: The Saviynt Identity Cloud application URL
{{path}}: The Identity Security for AI REST API version 1.0.
apiName: The API endpoint name.
For example: https://myorg.saviyntcloud.com/api/v2/agents
\nSet the {{url}} variables to match your Saviynt Identity Cloud application URL in the following format: https://SUBDOMAIN.saviyntcloud.com
For example: https://myorg.saviyntcloud.com
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"51302526","collectionId":"ff735f62-0277-4396-9735-6a314066188a","publishedId":"2sBXijKsGz","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-24T09:31:42.000Z"},"item":[{"name":"1.0 Authentication","item":[{"name":"Get Authorization Token","event":[{"listen":"test","script":{"id":"64b79d28-1559-4be4-9003-7f52564ba7cd","exec":[""],"type":"text/javascript","packages":{}}}],"id":"c6a1c1cf-6fe6-4578-a743-f0248c324f37","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"username\": \"Use this API to obtain an authentication token.
\nThe API requires the HTTP authentication scheme Bearer for authentication. All requests must have a valid Token specified in the HTTP Authorization header with the Bearer scheme.
Mandatory Parameters
\nusername: Specify the user name to log in to Saviynt Identity Cloud.
password: Specify the password to log in to Saviynt Identity Cloud.
A POST request, in which the username and password are passed in JSON text in the body, will return a Token in the response, which can be passed in a header variable for subsequent requests.
Use this API to search and filter agents.
\nFilter semantics
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","search"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"47c26033-b5f4-4f95-a2f4-84f6b962ccde","name":"Search & Filter Agents","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"searchQuery\": \"access review\",\n \"filters\": {\n \"agentIds\": [\"agent-abc\"],\n \"cloudPlatforms\": [\"AWS\", \"GCP\"],\n \"frameworks\": [\"Bedrock Agents\", \"Vertex AI\"],\n \"llmModels\": [\"gpt-4o\"],\n \"labels\": [\"risk_level:High\", \"compliance_scope:SOX\"],\n \"criticality\": [\"high\", \"critical\"],\n \"ownerIds\": [\"dsmith@example.com\"],\n \"status\": [\"active\"],\n \"source\": [\"API\"]\n },\n \"sort\": {\n \"field\": \"lastUsedAt\",\n \"direction\": \"desc\"\n },\n \"pagination\": {\n \"page\": 1,\n \"limit\": 25\n }\n}"},"url":"https://your-instance.example.com/api/v2/agents/search"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": [\r\n {\r\n \"agentId\": \"agent-c8f5d4ce-...\",\r\n \"displayName\": \"AccessReview-Bot\",\r\n \"name\": \"AccessReview-Bot\",\r\n \"url\": \"https://agent.example.com\",\r\n \"cloudPlatform\": \"AWS\",\r\n \"framework\": \"Bedrock Agents\",\r\n \"criticality\": \"high\",\r\n \"criticalityOverride\": false,\r\n \"status\": \"active\",\r\n \"source\": \"API\",\r\n \"agentMetadata\": {\r\n \"model\": \"gpt-4o\"\r\n },\r\n \"primaryOwner\": {\r\n \"ownerName\": \"Daniel Smith\",\r\n \"ownerContact\": \"dsmith@example.com\",\r\n \"ownerRole\": \"Business Owner\",\r\n \"rank\": 1,\r\n \"terminated\": false\r\n },\r\n \"additionalOwnerCount\": 2,\r\n \"labelCount\": 6,\r\n \"lastUsedAt\": \"2026-01-24T11:24:00Z\"\r\n }\r\n ],\r\n \"pagination\": {\r\n \"page\": 1,\r\n \"limit\": 25,\r\n \"totalCount\": 142,\r\n \"hasNextPage\": true\r\n }\r\n}"}],"_postman_id":"bbffce60-27ed-469c-924d-5bae2d2747b3"},{"name":"Get Filter Dropdown Values","id":"abf3d8e5-20ca-425a-8176-b97f0df119d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"target\": \"llmModels\",\n \"targetKey\": null,\n \"searchQuery\": \"gpt\",\n \"filters\": {\n \"cloudPlatforms\": [\"AWS\"]\n },\n \"pagination\": {\n \"page\": 1,\n \"limit\": 20\n }\n}"},"url":"{{url}}/api/v2/agents/filter-options","description":"Use this API to return distinct values and counts for a single filter dimension. Used to populate filter dropdowns in the UI.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","filter-options"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"cd727be3-446f-4e95-9671-cb75a5f3ed3f","name":"Get Filter Dropdown Values","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"target\": \"llmModels\",\n \"targetKey\": null,\n \"searchQuery\": \"gpt\",\n \"filters\": {\n \"cloudPlatforms\": [\"AWS\"]\n },\n \"pagination\": {\n \"page\": 1,\n \"limit\": 20\n }\n}"},"url":"{{url}}/api/v2/agents/filter-options"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"target\": \"llmModels\",\r\n \"options\": [\r\n {\r\n \"value\": \"gpt-4o\",\r\n \"label\": \"gpt-4o\",\r\n \"count\": 12\r\n },\r\n {\r\n \"value\": \"gemini-1.5-pro\",\r\n \"label\": \"gemini-1.5-pro\",\r\n \"count\": 8\r\n }\r\n ],\r\n \"pagination\": {\r\n \"totalCount\": 8,\r\n \"hasNextPage\": false\r\n }\r\n}"}],"_postman_id":"abf3d8e5-20ca-425a-8176-b97f0df119d3"},{"name":"Get Agent Detail","id":"35397982-ff3b-4c30-b7ae-017719eb536c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{url}}/api/v2/agents/Use this API to return the full agent object, including all owners (enriched with the terminated flag from identity_events) and all labels.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID. For example: agent-c8f5d4ce-0235-4009-ac1e-8f2f8df8ec62
Use this API to create a new agent record in pending status. Asynchronously triggers Policy Engine evaluation and automatically calculates criticality based on submitted owners.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"8f9e83f0-d43f-4495-9ebb-22aeea000e48","name":"Register Agent","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"name\": \"HR-Onboarding-Bot\",\n \"displayName\": \"New HR Agent\",\n \"url\": \"https://agent-hr.example.com\",\n \"environment\": \"prod\",\n \"agentType\": \"assistant\",\n \"cloudPlatform\": \"GCP\",\n \"framework\": \"Vertex AI\",\n \"agentMetadata\": {\n \"model\": \"gemini-1.5-pro\",\n \"temperature\": 0.5\n },\n \"rank1BusinessOwnerUserNames\": \"John Doe\",\n \"rank1BusinessOwnerEmails\": \"john@example.com\",\n \"rank1TechnicalOwnerUserNames\": \"Bob Singh\",\n \"rank1TechnicalOwnerEmails\": \"bob@example.com\",\n \"labels\": {\n \"Business Function\": \"HR\",\n \"compliance_scope\": \"SOX\"\n }\n}"},"url":"{{url}}/api/v2/agents"},"status":"Created","code":201,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"agent_id\": \"agent-abc123\",\r\n \"status\": \"pending\",\r\n \"created_at\": \"2024-01-01T12:00:00Z\"\r\n}"}],"_postman_id":"4cb9067c-654b-462c-ae83-a0aa0b0ea91c"},{"name":"Update Agent Fields","id":"a5e22764-8e16-4450-bded-6b9c84faacf0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"displayName\": \"Updated Agent Name\",\n \"description\": \"Updated description\",\n \"criticality\": \"critical\",\n \"criticalityOverride\": true\n}"},"url":"{{url}}/api/v2/agents/Use this API to partially update the provided fields. Owners and labels have dedicated endpoints.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID. For example: agent-c8f5d4ce-0235-4009-ac1e-8f2f8df8ec62
Note: To manually pin criticality, set criticalityOverrideto true; set it to false to restore auto-calculation.
Use this API to move the agent from the pending state to governance review.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Use this API to transition the agent to the approved state.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Use this API to make the agent active for operational use.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Use this API to temporarily disable an active agent.
\nNote: The disabled agent can be reactivated.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Use this API to permanently decommission an agent.
\nNote: This action cannot be undone.
\nMandatory URL Parameter
\nagentId: Specify the Agent UUID.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","State machine transitions. Valid flow: pending → review → approved → active ⇄ suspended → retired. All return 204 No Content.
\n","_postman_id":"3fd65e68-129a-4521-972a-7e8792875858","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}}},{"name":"4.0 Owners & Labels","item":[{"name":"Replace Owner List","id":"4df26625-3758-4604-8884-65a0b052fa9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"rank1BusinessOwnerUserNames\": \"John Doe\",\n \"rank1BusinessOwnerEmails\": \"john@example.com\",\n \"rank1TechnicalOwnerUserNames\": \"Jane Smith\",\n \"rank1TechnicalOwnerEmails\": \"jane@example.com\",\n \"rank2BusinessOwnerUserNames\": \"Alice Brown\",\n \"rank2BusinessOwnerEmails\": \"alice@example.com\"\n}"},"url":"{{url}}/api/v2/agents/Use this API to replace the complete owner list. Criticality is recalculated from the new owner counts unless criticalityOverride = true. Supports rank1-3 for both Business and Technical owners.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Use this API to replace the complete label set. Send {} to clear all labels. Keys are normalised: lowercase, spaces→underscores. Values must match ^[a-zA-Z0-9_-]+$. Duplicate normalised keys return 400.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","Returns all distinct normalised label keys across all agents in the tenant, ordered lexicographically ascending.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","labels"],"host":["{{url}}"],"query":[{"description":{"content":"Substring match on key name (optional)
\n","type":"text/plain"},"key":"filter","value":"risk"},{"description":{"content":"Max results, max 200 (default 50)
\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"Pagination offset (default 0)
\n","type":"text/plain"},"key":"offset","value":"0"}],"variable":[]}},"response":[],"_postman_id":"d23342c4-76a2-486e-b62e-466b0ec50c42"},{"name":"Get Label Taxonomy","id":"f85c2d69-ed93-437a-8a9b-dde028b924bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{url}}/api/v2/agents/labels/categories","description":"Use this API to return the static well-known label taxonomy. Values are suggestions; the API accepts any value matching ^[a-zA-Z0-9_-]+$. Categories: risk_level, data_sensitivity, compliance_scope, lifecycle_stage, agent_autonomy, blueprint_class.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","agents","labels","categories"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"2f733a6d-bd11-4745-9646-60faf0497d61","name":"Get Label Taxonomy","originalRequest":{"method":"GET","header":[],"url":"{{url}}/api/v2/agents/labels/categories"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"categories\": [\r\n { \"key\": \"risk_level\", \"displayName\": \"Risk Level\",\r\n \"values\": [\"Critical\", \"High\", \"Medium\", \"Low\"],\r\n \"purpose\": \"Drive approval depth and certification frequency.\",\r\n \"enforcement\": \"Auto-calculated or manual override\" },\r\n { \"key\": \"data_sensitivity\", \"displayName\": \"Data Sensitivity\",\r\n \"values\": [\"PII\", \"PHI\", \"Financial\", \"Public\"], ... },\r\n { \"key\": \"compliance_scope\", \"displayName\": \"Compliance Scope\",\r\n \"values\": [\"SOX\", \"HIPAA\", \"GDPR\", \"DORA\", \"PCI-DSS\"], ... },\r\n { \"key\": \"lifecycle_stage\", \"displayName\": \"Lifecycle Stage\",\r\n \"values\": [\"Development\", \"Testing\", \"Production\", \"Deprecated\"], ... },\r\n { \"key\": \"agent_autonomy\", \"displayName\": \"Agent Autonomy\",\r\n \"values\": [\"Assistive\", \"Semi-autonomous\", \"Fully-autonomous\"], ... },\r\n { \"key\": \"blueprint_class\", \"displayName\": \"Blueprint / Class\",\r\n \"values\": [\"Automation-Agent\", \"Workflow-Agent\", \"HR-Agent\", ...], ... }\r\n ]\r\n}"}],"_postman_id":"f85c2d69-ed93-437a-8a9b-dde028b924bf"}],"id":"86b21db8-ace3-454a-8c2e-ea3a240ef942","_postman_id":"86b21db8-ace3-454a-8c2e-ea3a240ef942","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}}},{"name":"5.0 Identity Events","item":[{"name":"Record IGA Lifecycle Event","id":"5381ff48-e068-413e-a2b2-71e21717af23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Correlation-ID","value":"6f563d2c-5f19-4df2-91c2-792a2dbcbc05","description":"UUID for cross-system tracing (required)
\n"},{"key":"X-API-Key","value":"","description":"Service-to-service API key (required)
\n"}],"body":{"mode":"raw","raw":"{\n \"userId\": \"sgreene@example.com\",\n \"eventType\": \"TERMINATE\",\n \"effectiveDate\": \"2026-02-26T14:30:00Z\",\n \"initiatedBy\": \"USER_IMPORT\",\n \"metadata\": {\n \"reason\": \"Voluntary resignation\",\n \"ticketId\": \"HR-4821\"\n }\n}"},"url":"{{url}}/api/v2/identity-events","description":"Use this API to receive IGA lifecycle notifications.
\nNote: Sending the same event twice returns 200 (already exists) instead of 201. The userId is matched against registry_owners.contact to find affected agents. Triggers async criticality recalculation.
\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}},"urlObject":{"path":["api","v2","identity-events"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5381ff48-e068-413e-a2b2-71e21717af23"}],"id":"becba744-405a-4d37-9cbc-fbd23e6803f3","_postman_id":"becba744-405a-4d37-9cbc-fbd23e6803f3","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"ff735f62-0277-4396-9735-6a314066188a","id":"ff735f62-0277-4396-9735-6a314066188a","name":"Identity Security for AI — API Reference","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"variable":[{"key":"baseUrl","value":"https://your-instance.example.com"},{"key":"jwt_token","value":""},{"key":"api_key","value":""},{"key":"agentId","value":"agent-c8f5d4ce-0235-4569-ac1e-8f2f8df8ec62"}]}