# Create an actor

Follow these steps to create a new actor:

1. Select the **Actors** icon on the left of the screen. 
2. In the page that opens, click **New** to create a new actor.
3. In the **New Actor** window, fill in these fields:
   1. In the **Name** edit box, enter a name for the actor. This field is mandatory. Note that blanks are not allowed.
   2. Optionally enter a **Description** for the actor.
   3. Under **Type**, select one of the following options:
      1. **Partner**: entities that interact with Data Mover and are external to the organization.
      2. **Application**: entities that interact with Data Mover and are external to the organization. Examples include Jira or SAP. 
   4. Optionally select the **Group** your actor belongs to.
   5. Optionally, **upload** **a logo** that will appear associated with the actor. Supported formats are: .jpg, .jpeg, .png and .svg.
   6. Click **Save** to confirm. The newly created Partner or Application will be added to the results list.

For each actor, the **3-dot** **icon** provides the following options:

* **Edit**: modify the actor’s name, description, and group.
* **Actor Lineage**: access the Actor Lineage feature (requires a separate license). Refer to the [Actor Lineage](/data-mover-1.20/actors/actor-lineage.md) page for details.
* **Delete**: remove the actor from the list.

## Options of the actors page

The Actors page is also equipped with a navigation bar and a panel with filters. 

The **navigation bar** is located at the top of the list of results and offers:

* Buttons to jump to the **First, Previous, Next,** and **Last** page.
* Ability to set the number of items that you want to display on each page choosing among 10, 20, and 50 items.
* Ability to refresh the list.

The **filters panel** is located on the right of the screen and can be used to search for actors by:

* **Actor Name**: enter the name of the actor or a part of the name you are searching for and press Enter on your keyboard or the **Apply** button. The edit box is **case-insensitive**. The search can be run even if you enter one single character – letter or number. Boolean searches are not supported.
* **Actor Description**: enter the description of the actor you are searching for and press Enter on your keyboard or the **Apply** button. The edit box is **case-insensitive**. The search can be run even if you enter one single character – letter or number. Boolean searches are not supported.
* **Actor Type**: select the type of actor you want to retrieve – Application and/or Partner – and then click the **Done** button. The chip or chips of the actor type will appear.

To run the query, click the **Apply** button. The result list will be updated with the actors satisfying the filters you have specified.\
To remove all filters in one go, click **Clear all** at the top-right corner of the filters panel. To remove a specific value, click the **x** in the chips or in the **Actor** edit box. 


---

# 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.primeur.com/data-mover-1.20/actors/create-an-actor.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.