조직 서비스 계정 만들기

POST /api/v1/organizations/{id}/service-accounts

조직 범위 고객 서비스 계정을 생성하고 해당 암호를 한 번 반환합니다. 역할은 필수이며 비어 있지 않은 이름 ORG_GROUP_CREATOR 또는 ORG_READ_ONLY를 최대 하나만 허용합니다. 레거시 에이전트 엔진 이름(ORG_ADMIN, ORG_MEMBER)은 계속 허용됩니다. role_assignments는 저장된 Agent Engine 역할 반영합니다. ORG_ADMIN이 필요합니다.

경로 매개변수

id 문자열 필수 사항

조직 ID

application/json

body 필수 사항

요청 만들기

description 문자열

최대 길이는 500입니다.
ip_access_list array[string]

선택적 IP/CIDR 허용 목록. 비어 있거나 생략되면 제한이 없음을 의미합니다. 최대 100 항목입니다.

요소가 100 개 이하입니다.
이름 문자열 필수 사항

최대 길이는 100입니다.
roles array[string] 필수 사항

역할은 초기 역할 설정하다 입니다. 정확히 하나 역할 필요합니다. 조직 계정은 ORG_GROUP_CREATOR 또는 ORG_READ_ONLY를 허용합니다. 프로젝트 계정은 PROJECT_OWNER, PROJECT_READ_ONLY 또는 AGENT_DEVELOPER를 허용합니다. 레거시 에이전트 엔진 이름(ORG_ADMIN, ORG_MEMBER, PROJECT_MEMBER)은 계속 허용됩니다. role_assignments는 해당 이름이 확인되는 저장된 Agent Engine 역할 반영합니다.

최소 1 개, 1 개 이하의 요소입니다.
secret_expires_after_hours integer

시간 단위의 시크릿 TTL (선택 사항). 생략하면 기본값은 2160(90일)입니다.

응답

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 상태 이유 구문입니다.
201

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

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

생성됨
응답 속성 숨기기 응답 속성 표시 객체
- client_secret 문자열
- service_account 객체
  
  service_account 속성 숨기기 service_account 속성 표시 객체
  
  active_secret 객체
  
  active_secret 속성 숨기기 active_secret 속성 표시 객체
  
  created_at 문자열
  
  expires_at 문자열
  
  last_used_at 문자열
  
  masked_value 문자열
  
  client_id 문자열
  
  created_at 문자열
  
  description 문자열
  
  id 문자열
  
  ip_access_list array[string]
  
  is_active 부울
  
  is_system_managed 부울
  
  이름 문자열
  
  org_id 문자열
  
  소유자 문자열
  
  PROJECT_ID 문자열
  
  role_assignments 배열[객체]
  
  role_assignments 속성 숨기기 role_assignments 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  역할 문자열
  
  유형 문자열
  
  updated_at 문자열
응답 속성 숨기기 응답 속성 표시 객체
- client_secret 문자열
- service_account 객체
  
  service_account 속성 숨기기 service_account 속성 표시 객체
  
  active_secret 객체
  
  active_secret 속성 숨기기 active_secret 속성 표시 객체
  
  created_at 문자열
  
  expires_at 문자열
  
  last_used_at 문자열
  
  masked_value 문자열
  
  client_id 문자열
  
  created_at 문자열
  
  description 문자열
  
  id 문자열
  
  ip_access_list array[string]
  
  is_active 부울
  
  is_system_managed 부울
  
  이름 문자열
  
  org_id 문자열
  
  소유자 문자열
  
  PROJECT_ID 문자열
  
  role_assignments 배열[객체]
  
  role_assignments 속성 숨기기 role_assignments 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  역할 문자열
  
  유형 문자열
  
  updated_at 문자열
400

application/json

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

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
403

application/json

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

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

application/json

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

찾을 수 없습니다.
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
409

application/json

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

충돌
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
429

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

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

요청이 너무 많음
헤더 속성 숨기기 헤더 속성 표시
- 재시도 후 문자열
  
  재시도 전 대기 시간(초)
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

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

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

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

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

서비스를 사용할 수 없음
헤더 속성 숨기기 헤더 속성 표시
- 재시도 후 문자열
  
  재시도 전 대기 시간(초)
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

POST /api/v1/organizations/{id}/service-accounts

curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/organizations/{id}/service-accounts' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "description": "string",
  "ip_access_list": [
    "string"
  ],
  "name": "string",
  "roles": [
    "string"
  ],
  "secret_expires_after_hours": 42
}'

요청 예시

{
  "description": "string",
  "ip_access_list": [
    "string"
  ],
  "name": "string",
  "roles": [
    "string"
  ],
  "secret_expires_after_hours": 42
}

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

응답 예시(201)

{
  "client_secret": "string",
  "service_account": {
    "active_secret": {
      "created_at": "string",
      "expires_at": "string",
      "last_used_at": "string",
      "masked_value": "string"
    },
    "client_id": "string",
    "created_at": "string",
    "description": "string",
    "id": "string",
    "ip_access_list": [
      "string"
    ],
    "is_active": true,
    "is_system_managed": true,
    "name": "string",
    "org_id": "string",
    "owner": "string",
    "project_id": "string",
    "role_assignments": [
      {
        "org_id": "string",
        "project_id": "string",
        "role": "string"
      }
    ],
    "type": "string",
    "updated_at": "string"
  }
}

응답 예시(201)

{
  "client_secret": "string",
  "service_account": {
    "active_secret": {
      "created_at": "string",
      "expires_at": "string",
      "last_used_at": "string",
      "masked_value": "string"
    },
    "client_id": "string",
    "created_at": "string",
    "description": "string",
    "id": "string",
    "ip_access_list": [
      "string"
    ],
    "is_active": true,
    "is_system_managed": true,
    "name": "string",
    "org_id": "string",
    "owner": "string",
    "project_id": "string",
    "role_assignments": [
      {
        "org_id": "string",
        "project_id": "string",
        "role": "string"
      }
    ],
    "type": "string",
    "updated_at": "string"
  }
}

응답 예시(400)

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

응답 예시(400)

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

응답 예시(403)

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

응답 예시(403)

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

응답 예시(404)

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

응답 예시(404)

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

응답 예시(409)

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

응답 예시(409)

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

응답 예시(429)

# Headers
Retry-After: string

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

응답 예시(429)

# Headers
Retry-After: string

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

응답 예시(500)

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

응답 예시(500)

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

응답 예시(503)

# Headers
Retry-After: string

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

응답 예시(503)

# Headers
Retry-After: string

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