Get Operator

Get a single operator by ID.

GET /api/operators/:id

Returns a single operator with its details.

Auth: Required — operator:manage permission

Path Parameters

Parameter	Type	Description
`id`	UUID	Operator ID

Example

curl https://api.reten.ai/api/operators/cc0e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"

const operatorId = "cc0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/operators/${operatorId}`, {
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
  },
});
const operator = await response.json();

import requests

operator_id = "cc0e8400-e29b-41d4-a716-446655440000"
response = requests.get(
    f"https://api.reten.ai/api/operators/{operator_id}",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
    },
)
operator = response.json()

Response `200 OK`

{
  "id": "cc0e8400-e29b-41d4-a716-446655440000",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phone": "+56912345678",
  "type": "SALESMAN",
  "externalId": "emp-001",
  "isActive": true,
  "isPlaceholder": false,
  "metadata": {},
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:30:00.000Z"
}

Error Responses

Status	Description
`404`	Operator not found