> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/agents/unmapping-identities-and-credentials-from-agents.md).

# Unmapping Identities and Credentials from Agents

### Overview

Use **Unmap from agent** when an identity or credential should no longer be treated as something the agent **has access to**.

Unmapping removes the **access association** in BalkanID. It does not:

* Delete the identity, credential, or agent
* Change identity-to-employee ownership mappings
* Revoke access in the source application

For how access mapping differs from identity-to-employee ownership mapping, see [Mapping Identities and Credentials to Agents](/agents/mapping-identities-and-credentials-to-agents.md).

### Unmap identities from an agent

1. Login to the BalkanID application and switch to the tenant you want to update.
2. Head to **Configure → Agents**.
3. Open the agent.
4. Open the **Identities** tab.
5. Select the identities to remove from the agent’s access associations.
6. Click **Unmap from agent**.<br>

   <figure><img src="/files/rDbZnmlU4RLccv7FTsaF" alt=""><figcaption></figcaption></figure>
7. Confirm the unmap action.

#### Result

The selected identities are no longer associated with the agent for access. The agent’s identity count updates after processing completes.

### Unmap credentials from an agent

1. Login to the BalkanID application and switch to the tenant you want to update.
2. Head to **Configure → Agents**.
3. Open the agent.
4. Open the **Credentials** tab.
5. Select the credentials to remove from the agent’s access associations.
6. Click **Unmap from agent**.<br>

   <figure><img src="/files/nPHn202LL0iuxNEgqQsd" alt=""><figcaption></figcaption></figure>
7. Confirm the unmap action.

#### Result

The selected credentials are no longer associated with the agent for access. The agent’s credential count updates after processing completes.

{% hint style="info" %}
Unmap is available from the agent detail tabs. Creating new access associations is done from the Identities and Credentials pages.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.balkan.id/agents/unmapping-identities-and-credentials-from-agents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
