# Manage users and user tags

Create, query, update, disable, or delete users, and maintain tags used to classify users. This page does not create roles or configure permission policies.

## Prerequisites

Prepare credentials that can access the target workspace. For service endpoints, authentication, and general request formats, see [Make your first AI Studio API call](https://omnifabric.cloudsigma.com/docs/developer/quickstart/index.html.md).

Before updating, disabling, deleting, or binding roles, obtain the target user ID from the user list. Before managing tags, list the available tags.

## Call sequence

1. First [list users](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/list-users.html.md) to identify a target user or create a new user.
2. After creation or update, query user-role bindings. To change roles, update the bindings, then query again to confirm.
3. To classify users by business purpose, create or update tags and query the tag list to confirm the result.
4. Before disabling or deleting a user, query user information and related records, then confirm impact and conditions on the action page.

## API operations

### Create and maintain users

| Task | Use it when |
| --- | --- |
| [Create a user](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/create-user.html.md) | Create a new user. |
| [Query users](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/list-users.html.md) | Select a target user or confirm a change. |
| [Update user information](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/update-user.html.md) | You have the user ID and need to modify user information. |
| [Update user status](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/update-user-status.html.md) | Adjust a target user's status. |
| [Delete a user](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/delete-user.html.md) | Confirm impact and conditions on the action page before deletion. |
| [Query user audit events](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/list-user-audit-events.html.md) | View audit events for a target user. |

### Manage user-role bindings

| Task | Use it when |
| --- | --- |
| [Query user-role bindings](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/get-user-role-bindings.html.md) | Confirm a user's roles before or after updating. |
| [Update user-role bindings](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/update-user-role-bindings.html.md) | You identified a user and roles and need to adjust their bindings. |

### Manage user tags

| Task | Use it when |
| --- | --- |
| [Create a tag](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/user-tags/create-user-tag.html.md) | You need a new user tag. |
| [Query tags](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/user-tags/list-user-tags.html.md) | Select or confirm tags. |
| [Update a tag](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/user-tags/update-user-tag.html.md) | You have the tag ID and need to modify it. |
| [Delete a tag](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/user-tags/delete-user-tag.html.md) | Confirm impact and conditions on the action page before deletion. |

## Confirm the result

After user changes, use [List users](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/list-users.html.md) and [Get user-role bindings](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/users/get-user-role-bindings.html.md) to confirm the result. After tag changes, use [List user tags](https://omnifabric.cloudsigma.com/docs/reference/api/ai-studio/users-and-permissions/user-tags/list-user-tags.html.md) to confirm them.

## Limitations and notes

Deleting users or tags and updating user status affect the target objects. Confirm conditions and results on the corresponding action page before proceeding.

## Next steps

- [Manage roles and inheritance](https://omnifabric.cloudsigma.com/docs/developer/api/ai-studio/users-permissions/roles-inheritance.html.md)
- [Configure data privileges](https://omnifabric.cloudsigma.com/docs/developer/api/ai-studio/users-permissions/data-privileges.html.md)