GET /api/v1/users/me
Bearer auth

Returns the current user's profile information from the database. Requires a valid Bearer token.

Responses

  • 406

    Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.
  • 200

    OK

    Hide response attributes Show response attributes object
    • atlas_connection_required boolean

      AtlasConnectionRequired is true when Atlas IAM delegation is on and no usable Atlas OAuth grant is available — including a recorded auth failure or circuit-open token. Federated login brokers a nested Atlas grant; password login may still auto-start GET /api/v1/oauth/atlas/initiate.

    • atlas_iam_enabled boolean

      AtlasIAMEnabled is true while Atlas IAM delegation is active for the user, independent of Atlas connection state (AtlasConnectionRequired flips off once a grant exists). The UI uses it to hide creation actions the Gateway rejects under delegation, such as creating Agent Engine organizations.

    • email string
    • last_selected_org_id string

      LastSelectedOrgID is the user's most recently selected organization ID in the UI. Hint only; callers re-validate against current memberships. Omitted when unset.

    • last_selected_project_id string

      LastSelectedProjectID is the user's most recently selected project ID in the UI. Hint only; callers re-validate against current memberships. Omitted when unset.

    • name string
    • org_ids array[string]
    • role_assignments array[object]
      Hide role_assignments attributes Show role_assignments attributes object
      • org_id string
      • project_id string
      • role string
    • user_id string
    Hide response attributes Show response attributes object
    • atlas_connection_required boolean

      AtlasConnectionRequired is true when Atlas IAM delegation is on and no usable Atlas OAuth grant is available — including a recorded auth failure or circuit-open token. Federated login brokers a nested Atlas grant; password login may still auto-start GET /api/v1/oauth/atlas/initiate.

    • atlas_iam_enabled boolean

      AtlasIAMEnabled is true while Atlas IAM delegation is active for the user, independent of Atlas connection state (AtlasConnectionRequired flips off once a grant exists). The UI uses it to hide creation actions the Gateway rejects under delegation, such as creating Agent Engine organizations.

    • email string
    • last_selected_org_id string

      LastSelectedOrgID is the user's most recently selected organization ID in the UI. Hint only; callers re-validate against current memberships. Omitted when unset.

    • last_selected_project_id string

      LastSelectedProjectID is the user's most recently selected project ID in the UI. Hint only; callers re-validate against current memberships. Omitted when unset.

    • name string
    • org_ids array[string]
    • role_assignments array[object]
      Hide role_assignments attributes Show role_assignments attributes object
      • org_id string
      • project_id string
      • role string
    • user_id string
  • 401

    Unauthorized

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 500

    Internal Server Error

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
GET /api/v1/users/me 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/users/me' \
 --header "Authorization: $API_KEY"
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
Response examples (200) 
{
  "atlas_connection_required": true,
  "atlas_iam_enabled": true,
  "email": "string",
  "last_selected_org_id": "string",
  "last_selected_project_id": "string",
  "name": "string",
  "org_ids": [
    "string"
  ],
  "role_assignments": [
    {
      "org_id": "string",
      "project_id": "string",
      "role": "string"
    }
  ],
  "user_id": "string"
}
Response examples (200) 
{
  "atlas_connection_required": true,
  "atlas_iam_enabled": true,
  "email": "string",
  "last_selected_org_id": "string",
  "last_selected_project_id": "string",
  "name": "string",
  "org_ids": [
    "string"
  ],
  "role_assignments": [
    {
      "org_id": "string",
      "project_id": "string",
      "role": "string"
    }
  ],
  "user_id": "string"
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}