Obtener usuario actual

OBTENER /api/v1/users/me
Autorización del portador

Devuelve la información del perfil del usuario actual desde la base de datos. Requiere un token Bearer válido.

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Se requiere conexión al atlas booleano

      AtlasConnectionRequired es verdadero cuando la delegación de Atlas IAM está activada y no hay disponible ninguna concesión OAuth de Atlas utilizable, incluido un fallo de autenticación registrado o un token de circuito abierto. El inicio de sesión federado gestiona una concesión de Atlas anidada; el inicio de sesión con contraseña aún puede iniciar automáticamente GET /api/v1/oauth/atlas/initiate.

    • atlas_iam_enabled booleano

      AtlasIAMEnabled es verdadero mientras la delegación de Atlas IAM esté activa para el usuario, independientemente del estado de la conexión de Atlas (AtlasConnectionRequired se desactiva una vez que existe una concesión). La interfaz de usuario lo utiliza para ocultar las acciones de creación que Gateway rechaza bajo delegación, como la creación de organizaciones de Agent Engine.

    • correo electrónico string
    • último_id_de_organización_seleccionado string

      LastSelectedOrgID es el ID de organización seleccionado más recientemente por el usuario en la interfaz de usuario. Solo como sugerencia; quienes realizan la llamada vuelven a validar la membresía actual. Se omite cuando no está configurado.

    • último_proyecto_seleccionado string

      LastSelectedProjectID es el ID del proyecto seleccionado más recientemente por el usuario en la interfaz de usuario. Solo como sugerencia; quienes realizan la llamada vuelven a validar la membresía actual. Se omite cuando no está configurado.

    • Nombre string
    • org_ids array[string]
    • asignaciones de roles arreglo[objeto]
      Ocultar atributos de asignación de roles Mostrar atributos de asignación de roles Objeto
      • org_id string
      • project_id string
      • rol string
    • user_id string
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Se requiere conexión al atlas booleano

      AtlasConnectionRequired es verdadero cuando la delegación de Atlas IAM está activada y no hay disponible ninguna concesión OAuth de Atlas utilizable, incluido un fallo de autenticación registrado o un token de circuito abierto. El inicio de sesión federado gestiona una concesión de Atlas anidada; el inicio de sesión con contraseña aún puede iniciar automáticamente GET /api/v1/oauth/atlas/initiate.

    • atlas_iam_enabled booleano

      AtlasIAMEnabled es verdadero mientras la delegación de Atlas IAM esté activa para el usuario, independientemente del estado de la conexión de Atlas (AtlasConnectionRequired se desactiva una vez que existe una concesión). La interfaz de usuario lo utiliza para ocultar las acciones de creación que Gateway rechaza bajo delegación, como la creación de organizaciones de Agent Engine.

    • correo electrónico string
    • último_id_de_organización_seleccionado string

      LastSelectedOrgID es el ID de organización seleccionado más recientemente por el usuario en la interfaz de usuario. Solo como sugerencia; quienes realizan la llamada vuelven a validar la membresía actual. Se omite cuando no está configurado.

    • último_proyecto_seleccionado string

      LastSelectedProjectID es el ID del proyecto seleccionado más recientemente por el usuario en la interfaz de usuario. Solo como sugerencia; quienes realizan la llamada vuelven a validar la membresía actual. Se omite cuando no está configurado.

    • Nombre string
    • org_ids array[string]
    • asignaciones de roles arreglo[objeto]
      Ocultar atributos de asignación de roles Mostrar atributos de asignación de roles Objeto
      • org_id string
      • project_id string
      • rol string
    • user_id string
  • 401

    No autorizado

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno del servidor

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
OBTENER /api/v1/users/me 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/users/me' \
 --header "Authorization: $API_KEY"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}