Skip to main content
Manages the many-to-many relationship between users and extensions. All endpoints require level 0 permission and a Bearer token. 
GET /api/v1/user-extensions

{
  "success": true,
  "message": "2 link(s) found",
  "data": [
    {
      "uuid": "770e8400-e29b-41d4-a716-446655440002",
      "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "extension_uuid": "660e8400-e29b-41d4-a716-446655440001",
      "username": "admin",
      "first_name": "Admin",
      "last_name": "User",
      "extension": "100",
      "ext_name": "Reception",
      "type": "chan_sip",
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  ],
  "metadata": {}
}

GET /api/v1/user-extensions/by-user/{userUuid}

{
  "success": true,
  "message": "2 extension(s) linked to user",
  "data": [
    {
      "uuid": "770e8400-e29b-41d4-a716-446655440002",
      "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "extension_uuid": "660e8400-e29b-41d4-a716-446655440001",
      "extension": "100",
      "ext_name": "Reception",
      "type": "chan_sip",
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  ],
  "metadata": {}
}

GET /api/v1/user-extensions/by-extension/{extUuid}

{
  "success": true,
  "message": "1 user(s) linked to extension",
  "data": [
    {
      "uuid": "770e8400-e29b-41d4-a716-446655440002",
      "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
      "extension_uuid": "660e8400-e29b-41d4-a716-446655440001",
      "username": "admin",
      "first_name": "Admin",
      "last_name": "User",
      "created_at": "2026-06-28T12:00:00.000Z"
    }
  ],
  "metadata": {}
}

POST /api/v1/user-extensions
FieldTypeRequired
user_uuidstringyes
extension_uuidstringyes
{
  "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "extension_uuid": "660e8400-e29b-41d4-a716-446655440001"
}

{
  "success": true,
  "message": "User linked to extension",
  "data": {
    "uuid": "770e8400-e29b-41d4-a716-446655440002",
    "user_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "extension_uuid": "660e8400-e29b-41d4-a716-446655440001",
    "username": "admin",
    "first_name": "Admin",
    "last_name": "User",
    "extension": "100",
    "ext_name": "Reception",
    "type": "chan_sip",
    "created_at": "2026-06-28T12:00:00.000Z"
  },
  "metadata": {}
}

DELETE /api/v1/user-extensions/{uuid}

{
  "success": true,
  "message": "Link deleted",
  "data": null,
  "metadata": {}
}