# Lifecycle Management APIs

Veza's Lifecycle Management APIs enable programmatic management of identity lifecycle processes for your organization. Use these APIs to automate provisioning, access changes, and deprovisioning through Access Profiles and Policy-based workflows.

The Lifecycle Management APIs help you:

* Create and manage Access Profiles that define collections of entitlements
* Build Policy workflows with conditional logic based on identity attributes
* Automate identity synchronization across systems
* Test policy configurations against specific identities
* Manage datasources available for lifecycle operations

See the [Lifecycle Management](/4yItIzMvkpAvMVFAamTf/features/lifecycle-management.md) product documentation for information about the basic components of Lifecycle Management, such as Policies, Access Profiles, and available actions for Lifecycle Management Integrations.

### Base URL

These endpoints are available under `{{VezaURL}}/api/private/` for private APIs and `{{VezaURL}}/api/v1/` for stable APIs. You must use the appropriate prefix when calling the API, for example:

```bash
curl -X GET 'https://your-org.vezacloud.com/api/private/lifecycle_management/policies'
```

### Authentication

### Available Endpoints

#### Identity Operations

Identities represent users managed by Lifecycle Management policies. Each identity is discovered from a policy's configured source of identity (such as Okta, Workday, or Active Directory) and tracks the user's access profiles, entitlements, and lifecycle state.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Get Identity</strong></td><td>Retrieve detailed identity information including access profiles and attributes</td><td><a href="/pages/EPkpbryN8eQOlgqwV9ku">/pages/EPkpbryN8eQOlgqwV9ku</a></td></tr><tr><td><strong>List Identity Entitlements</strong></td><td>Get all roles, groups, and entitlements assigned to an identity</td><td><a href="/pages/a5PG6NhBsB0DbcYaBrYS">/pages/a5PG6NhBsB0DbcYaBrYS</a></td></tr></tbody></table>

#### Access Profile Operations

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create Access Profile</strong></td><td>Create a new access profile with entitlements and settings</td><td><a href="/pages/JMc4E3HCHb6agLuJh8eG">/pages/JMc4E3HCHb6agLuJh8eG</a></td></tr><tr><td><strong>List Access Profiles</strong></td><td>Retrieve all access profiles with filtering and pagination</td><td><a href="/pages/vj66UUYDKJSZ4lAvuHz7">/pages/vj66UUYDKJSZ4lAvuHz7</a></td></tr><tr><td><strong>Update Access Profile Labels</strong></td><td>Modify labels and metadata for an access profile</td><td><a href="/pages/m5C0KJgh6uQG7VADSMmy">/pages/m5C0KJgh6uQG7VADSMmy</a></td></tr><tr><td><strong>Update Access Profile Members</strong></td><td>Modify entitlements and permissions within an access profile</td><td><a href="/pages/7fNAvlsLcV7Y9hzYVZbJ">/pages/7fNAvlsLcV7Y9hzYVZbJ</a></td></tr><tr><td><strong>List Access Profile Members</strong></td><td>View entitlements and permissions in an access profile</td><td><a href="/pages/mRerBzeY1NFzuyYMnVCb">/pages/mRerBzeY1NFzuyYMnVCb</a></td></tr><tr><td><strong>Update Access Profile Version</strong></td><td>Create new versions and manage access profile lifecycle</td><td><a href="/pages/B5Z7Mzc9ovXOcCqNBN8N">/pages/B5Z7Mzc9ovXOcCqNBN8N</a></td></tr></tbody></table>

#### Policy Operations

Policies define automated workflows triggered by changes in a source of identity. Each policy creates and manages a set of identities, tracking which workflows have executed and what access has been provisioned for each user.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create Policy</strong></td><td>Create a new lifecycle management policy with conditions</td><td><a href="/pages/rtSidr09KyMcdtKp9BuW">/pages/rtSidr09KyMcdtKp9BuW</a></td></tr><tr><td><strong>List Policies</strong></td><td>Retrieve all policies with filtering and pagination</td><td><a href="/pages/zpM7Iv99Myy2I4vdtnKj">/pages/zpM7Iv99Myy2I4vdtnKj</a></td></tr><tr><td><strong>Get Policy</strong></td><td>Retrieve details for a specific policy</td><td><a href="/pages/T7Ha4hrJxf45p6ZDFfGB">/pages/T7Ha4hrJxf45p6ZDFfGB</a></td></tr><tr><td><strong>Update Policy State</strong></td><td>Change policy execution state (running, paused, dry run)</td><td><a href="/pages/Hb0LrzJzrNHy0aW5QPgf">/pages/Hb0LrzJzrNHy0aW5QPgf</a></td></tr><tr><td><strong>Update Policy Configuration</strong></td><td>Modify policy workflows, conditions, and actions</td><td><a href="/pages/cv0exqIJVw0vxY79SWGA">/pages/cv0exqIJVw0vxY79SWGA</a></td></tr><tr><td><strong>Add Condition to Policy</strong></td><td>Add conditional logic to policy workflows</td><td><a href="/pages/ZrvTfw1K1tnlihJkCV6M">/pages/ZrvTfw1K1tnlihJkCV6M</a></td></tr><tr><td><strong>Add Action to Policy</strong></td><td>Add actions to policy workflows</td><td><a href="/pages/SpFLcsxRdlChctM6nZQa">/pages/SpFLcsxRdlChctM6nZQa</a></td></tr></tbody></table>

#### Administrative & Testing Operations

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Run Dry Run on Identity</strong></td><td>Test policy execution against specific identities without making changes</td><td><a href="/pages/joc2uJXPNvj5qORFeZgO">/pages/joc2uJXPNvj5qORFeZgO</a></td></tr><tr><td><strong>List Available Integrations</strong></td><td>Discover lifecycle management capabilities by integration type</td><td><a href="/pages/ESCfWxKjSOrLYZKf7fGc">/pages/ESCfWxKjSOrLYZKf7fGc</a></td></tr><tr><td><strong>Create Access Profile Type</strong></td><td>Create custom access profile types for organizational needs</td><td><a href="/pages/IB4wJ71ToOJUb0isu5zI">/pages/IB4wJ71ToOJUb0isu5zI</a></td></tr><tr><td><strong>List Access Profile Types</strong></td><td>Retrieve available access profile types</td><td><a href="/pages/pEkSvKGu8Fg3CK5LPbkM">/pages/pEkSvKGu8Fg3CK5LPbkM</a></td></tr><tr><td><strong>Parallel Execution Settings</strong></td><td>Configure concurrent workflow processing and paused task handling</td><td><a href="/pages/v36Y7YDIo8Pkhe0IvPdp">/pages/v36Y7YDIo8Pkhe0IvPdp</a></td></tr></tbody></table>

#### Activity Log Operations

The Activity Log APIs provide visibility into the execution history of lifecycle management workflows. These endpoints map to the tabs on the [Activity Log](/4yItIzMvkpAvMVFAamTf/features/lifecycle-management/getting-started/activity-log.md) page in the Veza UI.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Triggered Workflows</strong></td><td>List, inspect, export, unblock, and restart triggered workflow tasks</td><td><a href="/pages/xAggQMaydR8GgCRIW3fT">/pages/xAggQMaydR8GgCRIW3fT</a></td></tr><tr><td><strong>Workflow Actions</strong></td><td>List, inspect, and export action events within workflow tasks</td><td><a href="/pages/xkrGp3EHR4iVSZICzQyF">/pages/xkrGp3EHR4iVSZICzQyF</a></td></tr><tr><td><strong>Integration Jobs</strong></td><td>List, inspect, export, and push results for integration-level job events</td><td><a href="/pages/FFqtTmWOfuHrOrc6GGyX">/pages/FFqtTmWOfuHrOrc6GGyX</a></td></tr><tr><td><strong>Events</strong></td><td>List, inspect, and export granular entity-level change records</td><td><a href="/pages/bqjiHcSnJTr6WbGKSh9v">/pages/bqjiHcSnJTr6WbGKSh9v</a></td></tr></tbody></table>

#### Datasource Discovery Operations

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>List Lifecycle Management Datasources</strong></td><td>Discover which datasources have lifecycle management enabled and their basic capabilities</td><td><a href="/pages/Fl5OAKWiALFzsVSNnb6E">/pages/Fl5OAKWiALFzsVSNnb6E</a></td></tr><tr><td><strong>Get Lifecycle Management Datasource</strong></td><td>Get detailed information about a specific datasource including supported actions, syncable attributes, and grantable entitlements</td><td><a href="/pages/tRbrklCAu0z5TR9bfxAt">/pages/tRbrklCAu0z5TR9bfxAt</a></td></tr><tr><td><strong>List by Action Type</strong></td><td>Find datasources that support specific action types and entity relationships</td><td><a href="/pages/vsDuMfAfE9L77rxzE7iI">/pages/vsDuMfAfE9L77rxzE7iI</a></td></tr></tbody></table>

### Getting Started

To get started with the Lifecycle Management APIs:

1. **Discover available datasources** - Use the [Datasource Discovery Operations](#datasource-discovery-operations) to identify which datasources support lifecycle management
2. **Configure authentication** - Ensure you have the required API authentication configured (a personal API key for a Veza Root Team Administrator)
3. **Create access profiles** - Review the [Access Profile APIs](/4yItIzMvkpAvMVFAamTf/developers/api/lifecycle-management/accessprofiles.md) for creating and manage access collections
4. **Build policies** - Review the [Policy APIs](/4yItIzMvkpAvMVFAamTf/developers/api/lifecycle-management/policies.md) for endpoints to build automated provisioning workflows
5. **Test configurations** - Use the [Dry Run capabilities](/4yItIzMvkpAvMVFAamTf/developers/api/lifecycle-management/policies/rundryrunonidentity.md) before deploying to production

For conceptual information about Lifecycle Management, see the [Lifecycle Management documentation](/4yItIzMvkpAvMVFAamTf/features/lifecycle-management.md).

### Related APIs

For managing datasources that support lifecycle management capabilities:

* [Data Sources API](/4yItIzMvkpAvMVFAamTf/developers/api/management/datasources.md) - Core datasource management operations
* [Lifecycle Management Datasources](/4yItIzMvkpAvMVFAamTf/developers/api/management/datasources/listlifecyclemanagerdatasources.md) - Discover lifecycle-enabled datasources

### API Status

{% hint style="warning" %}
**Development Status**: The Veza Lifecycle Management APIs are in active development and subject to change. These APIs are provided under the `/private` API collection, and specifications may evolve as capabilities are added or modified.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.veza.com/4yItIzMvkpAvMVFAamTf/developers/api/lifecycle-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.