Skip to content

GetUser

GET/api/v1/users/{user}

Fetch a user by name, or using the alias users/me to return the currently authenticated user.

curl \
-H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
"https://us.oblique.security/api/v1/users/{user}"

Set OBLIQUE_API_KEY to your API key.

  • namestringrequired

    Name of the user of the format users/{id}. The alias users/me is also supported and resolves to the currently authenticated user.

200User

A user represents a human user in the directory.

  • namestring

    Assigned by Oblique. Format: users/{id}

  • createTimestring (date-time)read-only

    Create and update timestamps.

  • updateTimestring (date-time)read-only
  • deleteTimestring (date-time)read-only

    Users can only be soft-deleted to preserve logs and history.

  • displayNamestringrequired

    Primary display name of the user.

  • emailstringrequired

    Primary email of the user.

  • secondaryEmailsstring[]

    Additional emails of the user. These are in addition to the primary email.

  • titlestring

    Self reported role. “VP of Engineering”, “Senior Frontend Engineer”, “Engineering Director, Frontend”.

  • managerstring

    Optional manager of the user.

    Format: users/{user}

  • pictureUristring

    URI for the user’s profile picture. This can either be an https:// scheme, or an absolute path (/imgs/foo.png).

  • directReportCountinteger (int32)read-only

    Number of direct reports to this user.

  • totalReportCountinteger (int32)read-only

    Number of total reports to this user.

  • lastLoginTimestring (date-time)read-only

    The time the user last logged in. Not set if the user has never logged in.

StatusMeaning
400Malformed request
401Missing or invalid API key
403Not allowed for this API key
404Not found
429Too many requests
500Internal server error