{
  "opencollection": "1.0.0",
  "info": {
    "name": "Amigo Account Operators API",
    "version": "0.1.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Operators",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Operator dashboard overview",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/dashboard",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Live dashboard with operator status counts, active escalation queue, and today's escalation statistics."
        },
        {
          "info": {
            "name": "Operator performance summary",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/performance",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Aggregate performance across all operators with per-operator breakdown."
        },
        {
          "info": {
            "name": "List active escalations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/escalations/active",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "continuation_token",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List calls with active escalations (status: requested or connected)."
        },
        {
          "info": {
            "name": "Escalation statistics",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/escalations/stats",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "period",
                "value": "",
                "type": "query",
                "description": "Time period: day, week, or month."
              },
              {
                "name": "group_by",
                "value": "",
                "type": "query",
                "description": "Grouping dimension: status, trigger, or operator."
              }
            ]
          },
          "docs": "Aggregated escalation statistics over a time period."
        },
        {
          "info": {
            "name": "List escalation events",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/escalations",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "continuation_token",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List escalation lifecycle events for a workspace."
        },
        {
          "info": {
            "name": "Query audit log",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/audit-log",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "query",
                "description": "Filter by operator entity UUID."
              },
              {
                "name": "action",
                "value": "",
                "type": "query",
                "description": "Filter by exact operator audit event type."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "continuation_token",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Query audit events (operator actions) for a workspace."
        },
        {
          "info": {
            "name": "Get call transcript",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/calls/:call_sid/transcript",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "call_sid",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Per-speaker transcript segments from operator takeover sessions."
        },
        {
          "info": {
            "name": "Priority-ranked operator queue",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/queue",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Active calls ranked by operator priority: risk, wait time, emotion, loops, and safety concerns."
        },
        {
          "info": {
            "name": "Generate operator briefing",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/briefing",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Structured briefing for an operator about to join a call. Template-rendered from call intelligence and entity context."
        },
        {
          "info": {
            "name": "Join active call as operator",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/join-call",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Add operator to an active call's Twilio Conference."
        },
        {
          "info": {
            "name": "Remove operator from active call",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/leave-call",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Remove operator from an active call's Twilio Conference."
        },
        {
          "info": {
            "name": "Generate browser audio access token",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/access-token",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Generate a Twilio AccessToken with VoiceGrant for browser-based operator audio."
        },
        {
          "info": {
            "name": "Toggle operator listen/takeover mode",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/switch-mode",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Switch between listen mode and takeover mode."
        },
        {
          "info": {
            "name": "Send text guidance to agent during call",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/send-guidance",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Inject operator guidance into an active call. The agent incorporates it into its next response."
        },
        {
          "info": {
            "name": "Record operator intervention wrap-up",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id/wrap-up",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Persist the outcome and notes from an operator's call intervention."
        },
        {
          "info": {
            "name": "List operators",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "continuation_token",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "List all operator entities for a workspace."
        },
        {
          "info": {
            "name": "Register an operator",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create an operator entity with profile and initial offline status."
        },
        {
          "info": {
            "name": "Get an operator",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ]
          },
          "docs": "Get operator entity with computed state (profile, availability, performance)."
        },
        {
          "info": {
            "name": "Update an operator",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://api.amigo.ai/v1/:workspace_id/operators/:operator_id",
            "params": [
              {
                "name": "workspace_id",
                "value": "",
                "type": "path"
              },
              {
                "name": "operator_id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update operator profile fields or status. Each change writes a world event."
        }
      ]
    }
  ],
  "bundled": true
}