현재 사용자 가져오기

얻다 /api/v1/users/me

데이터베이스 에서 현재 사용자의 프로필 정보를 반환합니다. 유효한 무기명 토큰이 필요합니다.

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
200

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- atlas_connection_required 부울
  
  AtlasConnectionRequired는 Atlas IAM 위임이 켜져 있고 기록된 인증 실패 또는 회로 개방 토큰을 포함하여 사용 가능한 Atlas OAuth 권한 부여가 없는 경우에 true입니다. 연합 로그인 브로커 중첩된 Atlas 교부금입니다. 비밀번호 로그인은 여전히 GET /api/v1/oauth/atlas/initiate를 자동으로 시작할 수 있습니다.
- atlas_iam_enabled 부울
  
  Atlas IAM 위임이 사용자에 대해 활성화되어 있는 동안 AtlasIAMEnabled는 Atlas 연결 상태 와 관계없이 true입니다(AtlasConnectionRequired는 권한 부여가 존재하면 꺼집니다). UI 는 이를 사용하여 게이트웨이가 위임 시 거부하는 생성 작업(예: Agent Engine 조직 생성)을 숨깁니다.
- 이메일 문자열
- last_selected_org_id 문자열
  
  LastSelectedOrgID는 사용자가 UI 에서 가장 최근에 선택한 조직 ID 입니다. 힌트 전용입니다. 호출자는 현재 멤버십과 비교하여 다시 유효성을 검사합니다. 설정되지 않은 경우 생략됩니다.
- last_selected_project_id 문자열
  
  LastSelectedProjectID는 사용자가 UI 에서 가장 최근에 선택한 프로젝트 ID 입니다. 힌트 전용입니다. 호출자는 현재 멤버십과 비교하여 다시 유효성을 검사합니다. 설정되지 않은 경우 생략됩니다.
- 이름 문자열
- org_ids array[string]
- role_assignments 배열[객체]
  
  role_assignments 속성 숨기기 role_assignments 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  역할 문자열
- user_id 문자열
응답 속성 숨기기 응답 속성 표시 객체
- atlas_connection_required 부울
  
  AtlasConnectionRequired는 Atlas IAM 위임이 켜져 있고 기록된 인증 실패 또는 회로 개방 토큰을 포함하여 사용 가능한 Atlas OAuth 권한 부여가 없는 경우에 true입니다. 연합 로그인 브로커 중첩된 Atlas 교부금입니다. 비밀번호 로그인은 여전히 GET /api/v1/oauth/atlas/initiate를 자동으로 시작할 수 있습니다.
- atlas_iam_enabled 부울
  
  Atlas IAM 위임이 사용자에 대해 활성화되어 있는 동안 AtlasIAMEnabled는 Atlas 연결 상태 와 관계없이 true입니다(AtlasConnectionRequired는 권한 부여가 존재하면 꺼집니다). UI 는 이를 사용하여 게이트웨이가 위임 시 거부하는 생성 작업(예: Agent Engine 조직 생성)을 숨깁니다.
- 이메일 문자열
- last_selected_org_id 문자열
  
  LastSelectedOrgID는 사용자가 UI 에서 가장 최근에 선택한 조직 ID 입니다. 힌트 전용입니다. 호출자는 현재 멤버십과 비교하여 다시 유효성을 검사합니다. 설정되지 않은 경우 생략됩니다.
- last_selected_project_id 문자열
  
  LastSelectedProjectID는 사용자가 UI 에서 가장 최근에 선택한 프로젝트 ID 입니다. 힌트 전용입니다. 호출자는 현재 멤버십과 비교하여 다시 유효성을 검사합니다. 설정되지 않은 경우 생략됩니다.
- 이름 문자열
- org_ids array[string]
- role_assignments 배열[객체]
  
  role_assignments 속성 숨기기 role_assignments 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  역할 문자열
- user_id 문자열
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

GET /api/v1/users/me

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/users/me' \
 --header "Authorization: $API_KEY"

응답 예시(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"
}

응답 예시(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"
}

응답 예시(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"
}

응답 예시(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"
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}