Roles

GET /v1/firm-control/roles

curl -sS "$TRADARA_BASE_URL/v1/firm-control/roles" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "X-Firm-Entity-Slug: firm_acme"

{
  "items": [
    {
      "id": "rol_01HW...",
      "name": "Firm Admin",
      "entity_id": "ent_01HW...",
      "entity_slug": "firm_acme",
      "description": "Full administrative access for the firm."
    },
    {
      "id": "rol_01HV...",
      "name": "Risk Operator",
      "entity_id": "ent_01HW...",
      "entity_slug": "firm_acme",
      "description": "Can activate emergency halt and cancel any order."
    }
  ]
}

POST /v1/firm-control/roles

curl -X POST "$TRADARA_BASE_URL/v1/firm-control/roles" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "X-Firm-Entity-Slug: firm_acme" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Junior Support",
    "description": "Read-only access to accounts, orders, and fills."
  }'

{
  "id": "rol_01HW...",
  "name": "Junior Support",
  "entity_id": "ent_01HW...",
  "entity_slug": "firm_acme",
  "description": "Read-only access to accounts, orders, and fills."
}

PATCH /v1/firm-control/roles

curl -X PATCH "$TRADARA_BASE_URL/v1/firm-control/roles" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role_id": "rol_01HW...",
    "name": "Junior Support",
    "description": "Read-only access for first-tier support."
  }'

GET /v1/firm-control/staff/roles

curl -sS "$TRADARA_BASE_URL/v1/firm-control/staff/roles" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "X-Firm-Entity-Slug: firm_acme"

{
  "items": [
    {
      "id": "stf_01HW...",
      "auth_user_id": "8e9ad12c-2b1c-4e9a-9d3b-5e6c7a0d1f23",
      "is_active": true,
      "first_name": "Alex",
      "last_name": "Lin",
      "assignments": [
        {
          "id": "asg_01HW...",
          "role_id": "rol_01HW...",
          "scope_id": "ent_01HW...",
          "scope_kind": "firm",
          "role_name": "Risk Operator",
          "scope_slug": "firm_acme",
          "firm_name": "Acme Capital"
        }
      ]
    }
  ]
}