---
title: "Manual Registration"
slug: "manual-registration"
updated: 2026-10-11T15:45:56Z
published: 2026-10-11T15:45:56Z
canonical: "docs.plainid.io/manual-registration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plainid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual Registration

Manual registration allows you to add agents directly to the **AI Agent Registry**. This ensures full coverage of your agent inventory, including agents that are not connected through integrations.

Manually registered agents are treated the same as discovered agents. They follow the same schema, support the same **Attributes**, and can later be used in **Policy** creation and grouping.

Manually registered agents are fully integrated into the registry model. They:

- Use the same default **Attributes** as integrated agents.
- Support additional **Attributes** for enrichment.
- Can be grouped and used in **Policy** logic.
- Appear alongside all other agents in a unified inventory.

This capability is useful for internal agents, testing scenarios, or any agents that exist outside supported integrations.

## Registering an Agent

**To register an agent:**

1. From the Environment menu in the navigation bar, click **AI Agent Registry**.
2. Click **Register Agent**.
3. In the registration form, enter a **Display Name**.

> The Platform automatically fills in the **Agent ID** based on the Display Name, replacing spaces and special characters with underscores (_).

1. (Optional) Edit the **Agent ID**. After you edit the Agent ID, further changes to the Display Name no longer update it.
2. Provide values for any optional **Attributes**, including **Description**, **Status**, **Owner**, and **Tags**.
3. (Optional) Use the **Is Deleted** toggle to mark the agent for filtering purposes.
4. Click **Save**.

![Registering an Agent](https://cdn.document360.io/726c7002-05a9-480e-b986-42c9e8824acd/Images/Documentation/image(424).png)

Note

Each **Agent ID** must be unique in the Environment. Display Names do not need to be unique. If you register two agents with the same Display Name, the Platform generates the same Agent ID for both, and saving the second agent fails. In this event, change the Agent ID and save again.

Auto-fill applies only to manually registered agents, and only when you create them. Changing the Display Name of an existing agent does not change its Agent ID.

The agent is added to the registry and appears in the main table. You can click on an Agent to see their Agent card and information.

The **Vendor** **Attribute** is automatically set to **AI Agent Registry**, and the **Origin** **Attribute** reflects that the agent was created manually.

## Editing an Agent

You can update agent information after it has been created.

**To edit an agent:**

1. From the **AI Agent Registry**, locate the agent in the table.
2. Hover over the agent and click the edit option on the left.
3. Update the relevant values.
4. Click **Save** to apply the changes, or **Cancel** to discard them.

For manually registered agents, all **Attributes** can be edited.

For agents discovered through integrations, only user-defined additional **Attributes** can be edited. Default and vendor-specific **Attributes** are read-only.

## Deleting an Agent

Currently, manually registered agents cannot be deleted.

The **Is Deleted** toggle reflects deletion status but does not trigger additional system behavior beyond visibility and filtering.

## Agent Dynamic Groups

You group manually registered agents the same way as discovered agents, from the **Groups** tab in the **AI Agent Registry**. See [Managing Dynamic Groups for Agents](/v1/docs/managing-agent-dynamic-groups) to learn how to create, view, edit, and delete Dynamic Groups.