# Actors

{% hint style="warning" %}
**Navixy Repository API is a work in progress.** This documentation is published for preview purposes only and doesn't reflect a stable release. Structure, field names, and behaviors are subject to change.
{% endhint %}

Actors represent entities that can perform actions in the system. This includes users (human operators) and integrations (API clients and automated systems).

## Queries

### me

Retrieves the currently authenticated actor.

```graphql
me: Actor!
```

**Output types:**

<details>

<summary>Actor</summary>

An entity that can perform actions and have permissions assigned.

**Implements:** [Node](https://www.navixy.com/docs/navixy-repository-api/common#node), [Titled](https://www.navixy.com/docs/navixy-repository-api/common#titled)

| Field   | Type      | Description                    |
| ------- | --------- | ------------------------------ |
| `id`    | `ID!`     | A globally unique identifier.  |
| `title` | `String!` | The display name of the actor. |

</details>

***

## Objects

### PersonName

Structured person name components following [W3C Personal Names guidance](https://www.w3.org/International/questions/qa-personal-names).

Examples by culture:

* US: givenNames="John", familyNames="Smith", middleName="Robert"
* Russia: givenNames="Иван", familyNames="Иванов", middleName="Петрович" (patronymic)
* Spain: givenNames="Juan Carlos", familyNames="García López" (paternal + maternal)
* China: givenNames="明" (Ming), familyNames="王" (Wang) — note: family name first in native order
* Iceland: givenNames="Björk", familyNames="Guðmundsdóttir" (patronymic as family name)

| Field         | Type      | Description                                                                                     |
| ------------- | --------- | ----------------------------------------------------------------------------------------------- |
| `givenNames`  | `String!` | The given name(s), also known as first name(s). May contain multiple names separated by spaces. |
| `familyNames` | `String!` | The family name(s), also known as surname(s) or last name(s). May contain multiple names.       |
| `middleName`  | `String`  | The middle name, patronymic, or additional name component.                                      |
| `fullName`    | `String!` | The full name formatted according to the user's locale preferences.                             |

***

### SystemActor

The built-in system actor used for automated operations.

**Implements:** [Actor](#actor), [Node](https://www.navixy.com/docs/navixy-repository-api/common#node), [Titled](https://www.navixy.com/docs/navixy-repository-api/common#titled)

| Field   | Type      | Description                    |
| ------- | --------- | ------------------------------ |
| `id`    | `ID!`     | A globally unique identifier.  |
| `title` | `String!` | The display name of the actor. |

***

## Interfaces

### Actor

An entity that can perform actions and have permissions assigned.

**Implements:** [Node](https://www.navixy.com/docs/navixy-repository-api/common#node), [Titled](https://www.navixy.com/docs/navixy-repository-api/common#titled)

| Field   | Type      | Description                    |
| ------- | --------- | ------------------------------ |
| `id`    | `ID!`     | A globally unique identifier.  |
| `title` | `String!` | The display name of the actor. |

***