---
title: "Introspect"
method: POST
path: "/api/v1/users/introspect"
tags: ["User"]
---

# Introspect

`POST /api/v1/users/introspect`

Introspect returns the calling user's full UserView (profile, manager, attributes)
 resolved from the passport on the request.

## Request body

- C1ApiUserV1IntrospectRequest — The IntrospectRequest message.
  - `expandMask` C1ApiUserV1UserExpandMask — The user expand mask is used to indicate which related objects should be expanded in the response. The supported paths are 'role_ids', 'manager_ids', 'delegated_user_id', 'directory_ids', and '*'.
    - `paths` string[], nullable — An array of paths to be expanded in the response.

## Response `200`

Successful response

- C1ApiUserV1IntrospectResponse — The IntrospectResponse message.
  - `expanded` object[], nullable — The expanded field.
    - `@type` string — The type of the serialized message.
  - `userView` C1ApiUserV1UserView — The UserView object provides a user response object, as well as JSONPATHs to related objects provided by expanders.
    - `delegatedUserPath` string — JSONPATH expression indicating the location of the user objects of delegates of the current user in the expanded array.
    - `directoriesPath` string — JSONPATH expression indicating the location of directory objects in the expanded array.
    - `managersPath` string — JSONPATH expression indicating the location of the user objects that managed the current user in the expanded array.
    - `objectPermissions` C1ApiAuthorizationV1ActorObjectPermissions — ActorObjectPermissions describes which actions the calling user is permitted to perform on an object, as determined by policy.
      - `delete` boolean — The delete field.
      - `edit` boolean — The edit field.
      - `extra` object — The extra field.
      - `read` boolean — The read field.
    - `rolesPath` string — JSONPATH expression indicating the location of the roles of the current user in the expanded array.
    - `user` C1ApiUserV1User — The User object provides all of the details for an user, as well as some configuration.
      - `createdAt` string, date-time, nullable
      - `delegatedUserId` string — The id of the user to whom tasks will be automatically reassigned to.
      - `deletedAt` string, date-time, nullable
      - `department` string — The department which the user belongs to in the organization.
      - `departmentSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on department attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `directoryIds` string[], nullable — A list of unique ids that represent different directories.
      - `directoryStatus` 'UNKNOWN' | 'ENABLED' | 'DISABLED' | 'DELETED' — The status of the user in the directory.
      - `directoryStatusSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on directoryStatus attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `displayName` string — The display name of the user.
      - `email` string — This is the user's email.
      - `emailSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of source data for the email attribute.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `emails` string[], nullable — This is a list of all of the user's emails from app users.
      - `employeeIdSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of source data for the employee IDs attribute.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `employeeIds` string[], nullable — This is a list of all of the user's employee IDs from app users.
      - `employmentStatus` string — The users employment status.
      - `employmentStatusSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on employmentStatus attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `employmentType` string — The employment type of the user.
      - `employmentTypeSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on employmentType attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `id` string — A unique identifier of the user.
      - `jobTitle` string — The job title of the user.
      - `jobTitleSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on jobTitle attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `managerIds` string[], nullable — A list of ids of the user's managers.
      - `managerSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of objects mapped based on managerId attribute mappings configured in the system.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `origin` 'USER_ORIGIN_UNSPECIFIED' | 'USER_ORIGIN_DIRECTORY' | 'USER_ORIGIN_LOCAL' | 'USER_ORIGIN_SYSTEM' — The origin of the user, describing who owns the user's lifecycle.
      - `profile` object, nullable
      - `roleIds` string[], nullable — A list of unique identifiers that maps to ConductorOne's user roles let you assign users permissions tailored to the work they do in the software.
      - `status` 'UNKNOWN' | 'ENABLED' | 'DISABLED' | 'DELETED' — The status of the user in the system.
      - `type` 'USER_TYPE_UNSPECIFIED' | 'USER_TYPE_SYSTEM' | 'USER_TYPE_HUMAN' | 'USER_TYPE_SERVICE' | 'USER_TYPE_AGENT' — The type of the user.
      - `updatedAt` string, date-time, nullable
      - `username` string — This is the user's primary username. Typically sourced from the primary directory.
      - `usernameSources` C1ApiUserV1UserAttributeMappingSource[], nullable — A list of source data for the usernames attribute.
        - `appId` string — The appId field.
        - `appUserId` string — The appUserId field.
        - `appUserProfileAttributeKey` string — The appUserProfileAttributeKey field.
        - `priority` integer — Lower number = higher precedence; sources[0] is the winning source.
        - `userAttributeMappingId` string — The userAttributeMappingId field.
        - `value` string — The value field.
      - `usernames` string[], nullable — This is a list of all of the user's usernames from app users.
    - `userId` string — The id of the user.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)