Trifaco API
Empresa

Consultar actor

GET/v1/company/actors/{id}

Estado: implementada. Ambientes: simulation, qualification. Permisos: company:read.

Alcance: Devuelve un actor propio con ETag; identificadores ajenos responden 404.

Consultar actor

Authorization

ClientApiKey
X-API-Key<token>

Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.

In: header

Path Parameters

id*string

Identificador opaco. No autoriza acceso por sí mismo.

Formatuuid
Length1 <= length <= 36

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/company/actors/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "email": "user@example.com",  "roles": [    "owner"  ],  "status": "active",  "version": 1}

Registrar actor autorizado POST

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `actors:write`. **Alcance:** Alta idempotente de actores con roles distintos de propietario; correo único entre actores activos y máximo 50 activos por empresa/ambiente. No crea claves ni interfaz de acceso. Registrar actor autorizado

Actualizar permisos de actor PATCH

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `actors:write`. **Alcance:** Cambia roles o estado con If-Match e idempotencia; el propietario y el propio actor llamante no se modifican aquí. La reducción o desactivación aplica en la siguiente solicitud y no cancela documentos admitidos. Actualizar permisos de actor