*API REST › Objetos › Operaciones*

# Miembro del personal

> Miembro del personal, con la proyección mínima necesaria para planificar.

Un miembro del personal, con la proyección mínima necesaria para planificar: nombre, tipo de vinculación, colección, carné de conducir y referencia externa. Los datos de contacto, identidad, empleo, nómina y acceso a la plataforma no se publican, ni al leer ni al escribir. El personal está acotado a la suscripción que posee la clave.

Esquemas: `StaffMemberDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único del miembro del personal. |
| `fullName` | string | Nombre completo. |
| `staffType` | string | Tipo de miembro del personal. `employee`, `freelancer`, `contractor` |
| `collectionId` | string | Identificador de la colección a la que pertenece; null si no está en ninguna. |
| `collectionName` | string | Ruta de la colección a la que pertenece; null si no aplica. |
| `hasDrivingLicense` | boolean | true si tienen carnet de conducir. |
| `showInPlanner` | boolean | true si aparecen en el planificador de la cuenta. |
| `externalRef` | string | Referencia externa para cruzar con sistemas de terceros; null si no tiene. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC; null si no consta. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC; null si no está registrada. |

## Valores

| Campo | Valores |
| --- | --- |
| `staffType` | `employee`, `freelancer`, `contractor` |

## Ejemplo

*Staff member · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "fullName": "Example",
  "staffType": "employee",
  "collectionId": "string",
  "collectionName": "Example",
  "hasDrivingLicense": true,
  "showInPlanner": true,
  "externalRef": "string",
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/staff`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/list-staff) — Listar personal
- [`GET /api/v1/staff/{staffId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/get-a-staff-member) — Obtener un miembro del personal

## Lo modifican

- [`POST /api/v1/staff`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/create-a-staff-member) — Crear un miembro del personal
- [`PATCH /api/v1/staff/{staffId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/update-a-staff-member) — Actualizar un miembro del personal

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/staff-member  
Última actualización: 2026-10-25