---
updatedAt: 2026-04-15T19:06:06.000Z
---

# Get Single User Details

**Required Role:** Admin Portal or Admin API Consumer


Retrieves detailed information about a specific user including their configuration,
permissions, queue assignments, and related data.

The path parameter can be either a userId (26-character internal ID starting with '002')
or an email address.

Query parameters control which related data is included in the response.


# OpenAPI definition

```json
{
  "openapi": "3.1.1",
  "info": {
    "title": "User Management",
    "description": "APIs for creating, updating and retrieving individual users.\n",
    "version": "0.0.1",
    "contact": {
      "name": "Avaya API Team",
      "url": "https://developers.avayacloud.com/avaya-infinity/"
    },
    "license": {
      "name": "Avaya Software Development Kit (SDK) Software License Terms",
      "url": "https://support.avaya.com/css/P8/documents/101038288"
    }
  },
  "servers": [
    {
      "url": "https://core.{customerId}.ec.avayacloud.com/api/config/v1",
      "description": "Production",
      "variables": {
        "customerId": {
          "description": "Your organization identifier",
          "default": "your-org-id"
        }
      }
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "User",
      "description": "Operations related to individual users.\n"
    }
  ],
  "paths": {
    "/users/{userIdOrEmail}": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "Get Single User Details",
        "description": "**Required Role:** Admin Portal or Admin API Consumer\n\n\nRetrieves detailed information about a specific user including their configuration,\npermissions, queue assignments, and related data.\n\nThe path parameter can be either a userId (26-character internal ID starting with '002')\nor an email address.\n\nQuery parameters control which related data is included in the response.\n",
        "operationId": "getUser",
        "parameters": [
          {
            "$ref": "#/components/parameters/userIdOrEmail"
          },
          {
            "name": "queues",
            "in": "query",
            "description": "Include queue assignments with names",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "queueLogins",
            "in": "query",
            "description": "Include current queue login sessions",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "groups",
            "in": "query",
            "description": "Include group memberships",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "location",
            "in": "query",
            "description": "Include E911 location details",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "crmConfigId",
            "in": "query",
            "description": "Include CRM configuration",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "reportsTo",
            "in": "query",
            "description": "Include reports-to user details (supervisor/manager relationship)",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "externalUCProviderConnections",
            "in": "query",
            "description": "Include external UC provider connection details",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "User details retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserDetail"
                },
                "examples": {
                  "success": {
                    "$ref": "#/components/examples/GetUserDetailSuccess"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "default": {
            "$ref": "#/components/responses/InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "OAuth 2.0 Bearer Token with scoped permissions.\nRequired scopes documented per endpoint.\n"
      }
    },
    "responses": {
      "InternalServerError": {
        "description": "Internal Server Error",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://developers.avayacloud.com/errors/internal-error",
              "title": "Internal Server Error",
              "status": 500,
              "detail": "An unexpected error occurred while processing your request",
              "requestId": "req_xyz789",
              "timestamp": "2025-12-08T10:30:05Z"
            }
          }
        }
      },
      "BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://developers.avayacloud.com/errors/constraint-violation",
              "title": "Constraint Violation",
              "status": 400,
              "detail": "Request contains invalid or missing fields",
              "violations": [
                {
                  "field": "accountId",
                  "message": "must match \"^[a-zA-Z]{6}$\"",
                  "code": 20006
                }
              ]
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://developers.avayacloud.com/errors/unauthorized",
              "title": "Unauthorized",
              "status": 401,
              "detail": "Bearer token expired at 2025-12-08T10:15:00Z. Request a new token.",
              "requestId": "req_xyz789",
              "timestamp": "2025-12-08T10:30:05Z"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://developers.avayacloud.com/errors/forbidden",
              "title": "Forbidden",
              "status": 403,
              "detail": "Missing required scope: 'workflows:execute'. Your token has: 'workflows:read'",
              "requestId": "req_xyz789",
              "timestamp": "2025-12-08T10:30:05Z"
            }
          }
        }
      },
      "NotFound": {
        "description": "Not Found",
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://developers.avayacloud.com/errors/resource-not-found",
              "title": "Resource Not Found",
              "status": 404,
              "detail": "workflowId 'wf_123abc' does not exist",
              "requestId": "req_xyz789",
              "timestamp": "2025-12-08T10:30:05Z"
            }
          }
        }
      }
    },
    "parameters": {
      "userIdOrEmail": {
        "name": "userIdOrEmail",
        "in": "path",
        "description": "Either the user ID (26-character internal ID starting with '002'), email address,\nor the special value \"me\" to retrieve the current authenticated user.\n",
        "required": true,
        "schema": {
          "oneOf": [
            {
              "$ref": "#/components/schemas/UserId"
            },
            {
              "$ref": "#/components/schemas/Email"
            },
            {
              "type": "string",
              "enum": [
                "me"
              ],
              "description": "Current authenticated user"
            }
          ]
        }
      }
    },
    "schemas": {
      "UserListItem": {
        "type": "object",
        "properties": {
          "userId": {
            "$ref": "#/components/schemas/UserId"
          },
          "folderId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FolderId"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "firstName": {
            "type": "string",
            "example": "Banke"
          },
          "lastName": {
            "type": "string",
            "example": "S"
          },
          "fullName": {
            "$ref": "#/components/schemas/FullName"
          },
          "email": {
            "$ref": "#/components/schemas/Email"
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "$ref": "#/components/schemas/TagsList"
          },
          "tagsData": {
            "type": "object",
            "additionalProperties": true
          },
          "groups": {
            "type": [
              "string",
              "null"
            ]
          },
          "attributes": {
            "type": "object",
            "additionalProperties": true
          },
          "permissions": {
            "type": "object",
            "additionalProperties": true
          },
          "imageLastChangedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "queues": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UserQueues"
              },
              {
                "type": "null"
              }
            ],
            "description": "Queue assignments for this user."
          },
          "licType": {
            "type": "string",
            "example": "omniChannelAgentEnhanced"
          },
          "extension": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Extension"
              },
              {
                "type": "null"
              }
            ]
          },
          "mobile": {
            "type": [
              "string",
              "null"
            ]
          },
          "fw": {
            "type": [
              "string",
              "null"
            ]
          },
          "defaultOutboundCallerId": {
            "type": [
              "string",
              "null"
            ]
          },
          "emergencyOutboundCallerId": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string",
            "example": "enabled"
          },
          "createdOn": {
            "type": "string",
            "format": "date-time",
            "example": "2025-09-08 14:36:49"
          },
          "lastUpdated": {
            "type": "string",
            "format": "date-time",
            "example": "2025-09-08 14:38:10"
          },
          "createdBy": {
            "type": "object",
            "additionalProperties": true
          },
          "userStatus": {
            "type": "object",
            "additionalProperties": true
          },
          "scimExternalId": {
            "type": [
              "string",
              "null"
            ]
          },
          "authProvider": {
            "type": [
              "string",
              "null"
            ]
          },
          "directoryAble": {
            "type": "boolean"
          },
          "appTheme": {
            "$ref": "#/components/schemas/AppTheme"
          },
          "consoleTheme": {
            "$ref": "#/components/schemas/ConsoleTheme"
          },
          "isSupportUser": {
            "type": "boolean"
          },
          "calendarEventProvider": {
            "type": [
              "string",
              "null"
            ]
          },
          "calendarEventStatusMap": {
            "type": [
              "object",
              "null"
            ]
          },
          "interactionViewsType": {
            "type": "string"
          },
          "isDeleted": {
            "type": "boolean",
            "description": "Indicates if the user has been soft-deleted. Only present when includeDeleted query parameter is used."
          },
          "enableWebHID": {
            "$ref": "#/components/schemas/EnableWebHID"
          },
          "enableErrorTones": {
            "$ref": "#/components/schemas/EnableErrorTones"
          },
          "allowInternalCalls": {
            "$ref": "#/components/schemas/AllowInternalCalls"
          },
          "allowAgentEditAutoAnswer": {
            "$ref": "#/components/schemas/AllowAgentEditAutoAnswer"
          },
          "allowAgentEditWebHIDHeadsetControl": {
            "$ref": "#/components/schemas/AllowAgentEditWebHIDHeadsetControl"
          },
          "publicAlias": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PublicAlias"
              },
              {
                "type": "null"
              }
            ]
          },
          "namePrefix": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NamePrefix"
              },
              {
                "type": "null"
              }
            ]
          },
          "nameSuffix": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NameSuffix"
              },
              {
                "type": "null"
              }
            ]
          },
          "definedInteractionViews": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DefinedInteractionViews"
              },
              {
                "type": "null"
              }
            ]
          },
          "modifyInteractionViews": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ModifyInteractionViews"
              },
              {
                "type": "null"
              }
            ]
          },
          "rejectInteractions": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RejectInteractions"
              },
              {
                "type": "null"
              }
            ]
          },
          "isDigitalEnabled": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IsDigitalEnabled"
              },
              {
                "type": "null"
              }
            ]
          },
          "isVoiceEnabled": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IsVoiceEnabled"
              },
              {
                "type": "null"
              }
            ]
          },
          "previewOutbound": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PreviewOutbound"
              },
              {
                "type": "null"
              }
            ]
          },
          "crmConfigurations": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CrmConfigId"
              },
              {
                "type": "object",
                "additionalProperties": true
              },
              {
                "type": "null"
              }
            ],
            "description": "CRM configuration ID or object, depending on query parameters."
          },
          "personalQueueId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonalQueueId"
              },
              {
                "type": "null"
              }
            ]
          },
          "sendLogsToEdify": {
            "$ref": "#/components/schemas/SendLogsToEdify"
          }
        }
      },
      "UserDetail": {
        "type": "object",
        "description": "Detailed user object returned by the single-user GET endpoint. Extends the list item with optional enriched data controlled by query parameters.",
        "allOf": [
          {
            "$ref": "#/components/schemas/UserListItem"
          }
        ],
        "properties": {
          "queues": {
            "description": "Queue assignments. When queues=true, returns enriched object with named queues. When false, returns raw queue IDs.",
            "type": "object",
            "additionalProperties": true
          },
          "queueLogins": {
            "description": "Current queue login sessions. Only present when queueLogins=true.",
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "groups": {
            "description": "Group memberships. When groups=true, returns array of group objects. When false, field is omitted.",
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "groupId": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              }
            }
          },
          "location": {
            "description": "E911 location details. When location=true, returns location object. When false, field is omitted.",
            "type": "object",
            "additionalProperties": true
          },
          "crmConfigurations": {
            "description": "CRM configuration details. When crmConfigId=true, returns CRM config. When false, returns raw ID string.",
            "oneOf": [
              {
                "type": "object",
                "additionalProperties": true
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reportsTo": {
            "description": "Reports-to user details. When reportsTo=true, returns user object. When false, returns raw userId string.",
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string"
                  },
                  "firstName": {
                    "type": "string"
                  },
                  "lastName": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  }
                }
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "externalUCProviderConnections": {
            "description": "External UC provider connections. Only present when externalUCProviderConnections=true.",
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "personalQueueId": {
            "type": "string",
            "description": "The user's personal queue ID"
          },
          "infinityElements": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fwNumber": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FwNumber"
              },
              {
                "type": "null"
              }
            ]
          },
          "defaultOutboundCallerId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DefaultOutboundCallerId"
              },
              {
                "type": "null"
              }
            ]
          },
          "billingLocationId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BillingLocationId"
              },
              {
                "type": "null"
              }
            ]
          },
          "locationId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LocationId"
              },
              {
                "type": "null"
              }
            ]
          },
          "dialPlanProfileId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DialPlanProfileId"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteSbcGroupId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteSbcGroupId"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteAgentId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteAgentId"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteSipAddress": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteSipAddress"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteExtension": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteExtension"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteSipType": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteSipType"
              },
              {
                "type": "null"
              }
            ]
          },
          "eliteCmConfigurationId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EliteCmConfigurationId"
              },
              {
                "type": "null"
              }
            ]
          },
          "commTypeChangeDefaultValue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CommTypeChangeDefaultValue"
              },
              {
                "type": "null"
              }
            ]
          },
          "isEliteVoiceEnabled": {
            "$ref": "#/components/schemas/IsEliteVoiceEnabled"
          },
          "phoneSpaces": {
            "$ref": "#/components/schemas/PhoneSpaces"
          },
          "emailSpaces": {
            "$ref": "#/components/schemas/EmailSpaces"
          },
          "taskSpaces": {
            "$ref": "#/components/schemas/TaskSpaces"
          },
          "messagingSpaces": {
            "$ref": "#/components/schemas/MessagingSpaces"
          },
          "videoSpaces": {
            "$ref": "#/components/schemas/VideoSpaces"
          },
          "enableWebHID": {
            "$ref": "#/components/schemas/EnableWebHID"
          },
          "allowInternalCalls": {
            "$ref": "#/components/schemas/AllowInternalCalls"
          },
          "logConfiguration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LogConfiguration"
              },
              {
                "type": "null"
              }
            ]
          },
          "routeTo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RouteTo"
              },
              {
                "type": "null"
              }
            ]
          },
          "userRouteTo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UserRouteTo"
              },
              {
                "type": "null"
              }
            ]
          },
          "queueRouteTo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/QueueRouteTo"
              },
              {
                "type": "null"
              }
            ]
          },
          "video": {
            "type": [
              "string",
              "null"
            ]
          },
          "voice": {
            "type": [
              "string",
              "null"
            ]
          },
          "voicemail": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Voicemail"
              },
              {
                "type": "null"
              }
            ]
          },
          "channels": {
            "type": [
              "string",
              "null"
            ]
          },
          "aidStatusTypeOverride": {
            "$ref": "#/components/schemas/AidStatusTypeOverride"
          },
          "sipTrunkId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SipTrunkId"
              },
              {
                "type": "null"
              }
            ]
          },
          "sipTranslation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SipTranslation"
              },
              {
                "type": "null"
              }
            ]
          },
          "tabs": {
            "$ref": "#/components/schemas/Tabs"
          },
          "defaultTab": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DefaultTab"
              },
              {
                "type": "null"
              }
            ]
          },
          "ucPhoneSpaces": {
            "$ref": "#/components/schemas/UcPhoneSpaces-2"
          },
          "e911Recommendations": {
            "$ref": "#/components/schemas/E911Recommendations"
          },
          "hasEliteAgentIdPassword": {
            "$ref": "#/components/schemas/HasEliteAgentIdPassword"
          },
          "hasEliteCommunicationProfilePassword": {
            "$ref": "#/components/schemas/HasEliteCommunicationProfilePassword"
          },
          "hasEliteExtensionPassword": {
            "$ref": "#/components/schemas/HasEliteExtensionPassword"
          },
          "isEliteAutoSyncEnabled": {
            "$ref": "#/components/schemas/IsEliteAutoSyncEnabled"
          },
          "useUCPhoneSpaceOnCCCall": {
            "$ref": "#/components/schemas/UseUCPhoneSpaceOnCCCall-2"
          },
          "useCCPhoneSpaceOnUCCall": {
            "$ref": "#/components/schemas/UseCCPhoneSpaceOnUCCall-2"
          },
          "sendLogsToEdify": {
            "$ref": "#/components/schemas/SendLogsToEdify"
          },
          "uc3Endpoint": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Uc3Endpoint"
              },
              {
                "type": "null"
              }
            ]
          },
          "userAID": {
            "$ref": "#/components/schemas/UserAID"
          }
        }
      },
      "FolderId": {
        "description": "Unique identifier for a folder.",
        "type": "string",
        "pattern": "^073[0-9a-f]{23}$",
        "example": "073d010813b941cf7da111d147"
      },
      "LocationId": {
        "type": "string",
        "description": "Optional location ID to associate with the user or profile. Must be an existing location ID.\n\n**Note:** Location IDs are system-generated 26-character identifiers with prefix \"022\".\n",
        "maxLength": 26,
        "minLength": 26,
        "pattern": "^022[0-9a-f]{23}$",
        "example": "022d01091776cc88fe6866b7ce"
      },
      "Violation": {
        "type": "object",
        "properties": {
          "field": {
            "description": "The name of the field in the request that caused the violation.\n\nThis can be the name of a path parameter, query parameter, or a field within the request body.\n",
            "type": "string",
            "readOnly": true,
            "example": "jobName"
          },
          "message": {
            "description": "A human-readable explanation specific to this occurrence of the violation.\n",
            "type": "string",
            "readOnly": true,
            "example": "must match \"^[a-zA-Z]{6}$\""
          },
          "code": {
            "description": "The violation code generated by the server for this occurrence of the violation.\n\nUse this code when implementing any error handling logic instead of the message, as the message can change.\n",
            "type": "integer",
            "format": "int32",
            "readOnly": true,
            "example": 20006
          }
        },
        "required": [
          "field",
          "message",
          "code"
        ],
        "example": [
          {
            "field": "emailAddress",
            "message": "must not be null",
            "code": 20002
          }
        ]
      },
      "Problem": {
        "type": "object",
        "description": "<b>Problem Detail</b> is a way to carry machine-readable details of errors in an HTTP\nresponse to avoid the need to define new error response formats for HTTP APIs\n\n<a href=\"https://tools.ietf.org/html/rfc7807\">RFC 7807</a>\n",
        "properties": {
          "type": {
            "description": "An absolute URI that identifies the problem type.\n\nWhen dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML).\n",
            "type": "string",
            "format": "uri",
            "readOnly": true,
            "example": "https://developers.avayacloud.com/avaya-infinity/docs/user-management#error-reference"
          },
          "title": {
            "description": "A short, summary of the problem type.\n\nWritten in English and readable for engineers (usually not suited for non technical stakeholders and not localized).\n",
            "type": "string",
            "readOnly": true,
            "example": "Service Unavailable"
          },
          "status": {
            "description": "The HTTP status code generated by the origin server for this occurrence of the problem.\n",
            "type": "integer",
            "format": "int32",
            "minimum": 300,
            "exclusiveMaximum": 600,
            "readOnly": true,
            "example": 503
          },
          "detail": {
            "description": "A human-readable explanation specific to this occurrence of the problem.\n",
            "type": "string",
            "readOnly": true,
            "example": "Connection to database timed out"
          },
          "instance": {
            "description": "An absolute URI that identifies the specific occurrence of the problem.\n\nIt may or may not yield further information if dereferenced.\n",
            "type": "string",
            "format": "uri",
            "readOnly": true
          },
          "violations": {
            "description": "A list of violations that occurred as a result of invalid data provided as part of a request.\n",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Violation"
            },
            "readOnly": true
          }
        }
      },
      "UserId": {
        "description": "Unique identifier for a user.",
        "type": "string",
        "pattern": "^002[0-9a-f]{23}$",
        "example": "002507f1e1c8e3e9a8b7c5d4e3f2"
      },
      "FullName": {
        "description": "The full name of the user (firstName + lastName).",
        "type": "string",
        "example": "John Smith"
      },
      "Email": {
        "description": "A user's email address",
        "type": "string",
        "format": "email"
      },
      "TagsList": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "List of tag names associated with the user or profile.",
        "example": [
          "APACT",
          "English",
          "NART"
        ]
      },
      "QueueId": {
        "description": "Unique identifier for a queue.",
        "type": "string",
        "minLength": 23,
        "maxLength": 26,
        "pattern": "^003[0-9a-f]{20,23}$",
        "example": "00301090301ad8db0f0d4c370"
      },
      "UserQueues": {
        "description": "Queues configuration for a user or profile.",
        "type": "object",
        "properties": {
          "access": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueueId"
            }
          },
          "performance": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueueId"
            }
          },
          "autoLogin": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueueId"
            }
          },
          "proficiency": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueueId"
            }
          },
          "logins": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueueId"
            }
          },
          "defaultOutboundQueue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/QueueId"
              },
              {
                "type": "null"
              }
            ]
          },
          "outboundQueueId": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/QueueId"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "Extension": {
        "description": "The extension of an agent user.",
        "type": "string",
        "example": "1001"
      },
      "UiTheme": {
        "type": "string",
        "enum": [
          "light",
          "dark"
        ],
        "example": "light"
      },
      "AppTheme": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UiTheme"
          }
        ],
        "description": "Application theme preference"
      },
      "ConsoleTheme": {
        "allOf": [
          {
            "$ref": "#/components/schemas/UiTheme"
          }
        ],
        "description": "Console theme preference"
      },
      "EnableWebHID": {
        "type": "boolean",
        "description": "Whether WebHID is enabled for the user"
      },
      "EnableErrorTones": {
        "type": "boolean",
        "description": "Whether error tones are enabled."
      },
      "AllowInternalCalls": {
        "type": "boolean",
        "description": "Whether the user or profile can make internal calls"
      },
      "AllowAgentEditAutoAnswer": {
        "type": "boolean",
        "description": "Controls whether the agent is allowed to edit their own Auto Answer Interactions setting (attributes.webRTC.autoAnswer.interaction) via the Edit Profile API. Defaults to false (agent cannot edit). When false and an agent attempts a self-edit that includes an Auto Answer change, the server returns HTTP 403 Forbidden. Administrators can always modify Auto Answer for any user regardless of this flag.",
        "default": false
      },
      "AllowAgentEditWebHIDHeadsetControl": {
        "type": "boolean",
        "description": "Controls whether the agent is allowed to edit their own WebHID Headset Control setting (attributes.webHID.status) via the Edit Profile API. Defaults to false (agent cannot edit). When false and an agent attempts a self-edit that includes a WebHID status change, the server returns HTTP 403 Forbidden. Administrators can always modify WebHID settings for any user regardless of this flag.",
        "default": false
      },
      "PublicAlias": {
        "description": "The public alias of a user. Supports letters (including international characters), digits, spaces, hyphens, and apostrophes.",
        "type": "string",
        "minLength": 2,
        "maxLength": 100,
        "pattern": "^[\\p{L}0-9 '\\-]*$",
        "example": "John Smith"
      },
      "NamePrefix": {
        "description": "The name prefix of a user.",
        "type": "string"
      },
      "NameSuffix": {
        "description": "The name suffix of a user.",
        "type": "string",
        "enum": [
          "Jr",
          "Sr",
          "I",
          "II",
          "III",
          "IV",
          "V",
          "CLU",
          "CO",
          "CPA",
          "DDS",
          "ESQ",
          "MD",
          "PhD",
          "RN"
        ]
      },
      "DefinedInteractionViews": {
        "type": "array",
        "description": "List of defined interaction views",
        "items": {
          "type": "string"
        }
      },
      "ModifyInteractionViews": {
        "type": "boolean",
        "description": "Can modify interaction views",
        "example": true
      },
      "RejectInteractions": {
        "type": "boolean"
      },
      "IsDigitalEnabled": {
        "type": "boolean"
      },
      "IsVoiceEnabled": {
        "type": "boolean"
      },
      "PreviewOutbound": {
        "type": "boolean"
      },
      "CrmConfigId": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "minLength": 36,
        "maxLength": 36
      },
      "PersonalQueueId": {
        "description": "The user's personal queue ID.",
        "allOf": [
          {
            "$ref": "#/components/schemas/QueueId"
          }
        ]
      },
      "SendLogsToEdify": {
        "description": "Whether to send logs to Edify.",
        "type": "boolean"
      },
      "FwNumber": {
        "type": "string",
        "pattern": "^[\\d+\\s().-]*$"
      },
      "DefaultOutboundCallerId": {
        "type": "string",
        "minLength": 10
      },
      "BillingLocationId": {
        "type": "string"
      },
      "CommTypeChangeDefaultValue": {
        "type": "string",
        "description": "Default value for communication type changes",
        "enum": [
          "callback",
          "closeResolved",
          "closeUnresolved"
        ],
        "example": "callback"
      },
      "Spaces": {
        "type": "object",
        "description": "Space configuration for a user or profile.",
        "properties": {
          "task": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "email": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "phone": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "video": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "messaging": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IsEliteVoiceEnabled": {
        "type": "boolean"
      },
      "EliteSbcGroupId": {
        "description": "The ID of the default SBC Group to use for calls involving this hybrid agent.",
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "minLength": 36,
        "maxLength": 36
      },
      "EliteAgentId": {
        "description": "The hybrid agent's ID on Aura.",
        "type": "string",
        "minLength": 1
      },
      "EliteSipAddress": {
        "description": "The SIP address for the hybrid agent.",
        "type": "string",
        "format": "email"
      },
      "EliteExtension": {
        "description": "The hybrid agent's extension on Aura.",
        "type": "string",
        "minLength": 1
      },
      "EliteSipType": {
        "type": "string",
        "enum": [
          "UDP",
          "TCP",
          "TLS"
        ]
      },
      "EliteCmConfigurationId": {
        "description": "The ID of the Elite CM Configuration associated with this user",
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "minLength": 36,
        "maxLength": 36
      },
      "DialPlanProfileId": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
        "minLength": 36,
        "maxLength": 36,
        "description": "ID of the dial plan profile to use"
      },
      "PhoneSpaces": {
        "type": "integer",
        "minimum": 0
      },
      "LogConfiguration": {
        "type": "object",
        "description": "Log configuration settings for controlling logging behavior.\nUsed to configure client-side logging for users and profiles.\n",
        "properties": {
          "logLevel": {
            "type": "string",
            "enum": [
              "ERROR",
              "WARN",
              "INFO",
              "DEBUG",
              "TRACE"
            ],
            "description": "The minimum log level to capture",
            "example": "INFO"
          },
          "remoteLoggingEnabled": {
            "type": "boolean",
            "description": "Whether to send logs to the remote logging service",
            "example": true
          },
          "sampleRate": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Sampling rate for logs (0 to 1, where 1 means log everything)",
            "example": 0.5
          },
          "modules": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of module names to enable logging for",
            "example": [
              "auth",
              "api",
              "websocket"
            ]
          }
        }
      },
      "EmailSpaces": {
        "type": "integer",
        "minimum": 0
      },
      "TaskSpaces": {
        "type": "integer",
        "minimum": 0
      },
      "MessagingSpaces": {
        "type": "integer",
        "minimum": 0
      },
      "VideoSpaces": {
        "type": "integer",
        "minimum": 0
      },
      "RouteTo": {
        "description": "Route-to configuration for the user.",
        "type": "string"
      },
      "UserRouteTo": {
        "description": "User-level route-to setting (e.g., 'endpoints').",
        "type": "string"
      },
      "QueueRouteTo": {
        "description": "Queue-level route-to setting.",
        "type": "string"
      },
      "Voicemail": {
        "description": "Voicemail configuration object.",
        "type": "object",
        "additionalProperties": true
      },
      "AidStatusTypeOverride": {
        "description": "Whether the user has an AID status type override.",
        "type": "boolean"
      },
      "SipTrunkId": {
        "description": "SIP trunk ID.",
        "type": "string"
      },
      "SipTranslation": {
        "description": "SIP translation setting.",
        "type": "string"
      },
      "Tabs": {
        "description": "User-configured UI tabs.",
        "type": "array",
        "items": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "DefaultTab": {
        "description": "The user's default tab.",
        "type": "string"
      },
      "UcPhoneSpaces-2": {
        "description": "Number of UC phone interaction spaces.",
        "type": "integer",
        "minimum": 0
      },
      "E911Recommendations": {
        "description": "E911 recommendation setting.",
        "type": "string"
      },
      "HasEliteAgentIdPassword": {
        "description": "Whether the user has an Elite agent ID password set.",
        "type": "boolean"
      },
      "HasEliteCommunicationProfilePassword": {
        "description": "Whether the user has an Elite communication profile password set.",
        "type": "boolean"
      },
      "HasEliteExtensionPassword": {
        "description": "Whether the user has an Elite extension password set.",
        "type": "boolean"
      },
      "IsEliteAutoSyncEnabled": {
        "description": "Whether Elite auto-sync is enabled for this user.",
        "type": "boolean"
      },
      "UseUCPhoneSpaceOnCCCall-2": {
        "description": "Use UC phone space for CC calls.",
        "type": "boolean"
      },
      "UseCCPhoneSpaceOnUCCall-2": {
        "description": "Use CC phone space for UC calls.",
        "type": "boolean"
      },
      "Uc3Endpoint": {
        "description": "UC3 endpoint session information.",
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "sessionToken": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          }
        }
      },
      "UserAID": {
        "description": "Auto Interaction Distribution (AID) state for the user.",
        "type": "object",
        "properties": {
          "isAID": {
            "type": [
              "string",
              "boolean"
            ]
          },
          "spaces": {
            "$ref": "#/components/schemas/Spaces"
          },
          "limits": {
            "type": "object",
            "additionalProperties": {
              "type": "integer"
            }
          },
          "lastSelected": {
            "type": [
              "string",
              "null"
            ]
          },
          "lastEndedInteractionTime": {
            "type": "string"
          }
        }
      }
    },
    "examples": {
      "GetUserDetailSuccess": {
        "description": "Successful user retrieval",
        "value": {
          "userId": "002d011003cf7c9d1b469ddc7e",
          "email": "hitenagent@avaya113.com",
          "firstName": "Hiten",
          "lastName": "Agent",
          "fullName": "Hiten Agent",
          "licType": "omniChannelAgentEnhanced",
          "status": "enabled",
          "createdOn": "2025-09-08T14:36:49Z",
          "lastUpdated": "2025-09-08T14:38:10Z",
          "tags": [],
          "attributes": {},
          "permissions": {}
        }
      }
    }
  }
}
```