Trifaco API
Empresa

Registrar actor autorizado

POST/v1/company/actors

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

Authorization

ClientApiKey
X-API-Key<token>

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

In: header

Header Parameters

Idempotency-Key*string

Obligatoria en mutaciones. Alcance: empresa/ambiente/operación/recurso destino. Retención mínima 90 días y mientras haya trabajo pendiente. Mismo contenido recupera resultado; contenido diferente produce 409.

Match^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Length1 <= length <= 128

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

No permite otorgar owner: usa transferencia de propiedad. El rol no crea una interfaz de acceso.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/company/actors" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "email": "user@example.com",    "roles": [      "administrator"    ]  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "email": "user@example.com",  "roles": [    "owner"  ],  "status": "active",  "version": 1}

Listar actores GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Lista los actores de la empresa con paginación y cursor ligados al ambiente y la consulta. Listar actores

Consultar actor GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `company:read`. **Alcance:** Devuelve un actor propio con ETag; identificadores ajenos responden 404. Consultar actor