프로젝트 생성

POST /api/v1/orgs/{orgId}/projects

URL 경로에서 조직 내에서 새 프로젝트 만듭니다. 에이전트 엔진 네이티브 조직에는 ORG_ADMIN 또는 SYSTEM_ADMIN이 필요하며 에이전트 엔진 프로젝트 삽입합니다. Atlas 지원 조직은 호출자의 위임된 Atlas 권한 부여(해당 조직의 ORG_ADMIN, Atlas ORG_OWNER 또는 ORG_GROUP_CREATOR)를 사용하여 Atlas 에서 프로젝트 생성하고 Agent Engine 프로젝트 기록 반환합니다. Atlas 조직에 Agent Engine이 소유한 하위 항목은 생성되지 않습니다.

경로 매개변수

orgId 문자열 필수 사항

조직 ID

application/json

body 필수 사항

생성할 프로젝트

allow_member_invites 부울
description 문자열
이름 문자열 필수 사항

유효성 검사 전에 이름이 잘립니다. 1~64자여야 하며 유니코드 문자/숫자, 공백 및 문자 - 를 포함할 수 있습니다. ( ) , & @ + '.

최소 길이는 1, 최대 길이는 64입니다.
공유 정책 객체
공유 정책 속성 숨기기 공유 정책 속성 표시 객체
- 허용된 소스 array[string]
- Share_modes array[string]
- 공유 가능 부울

응답

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

생성됨
응답 속성 숨기기 응답 속성 표시 객체
- allow_member_invites 부울
- Atlas 객체
  
  Atlas 속성 숨기기 Atlas 속성 표시 객체
  
  환경 문자열 필수 사항
  
  id 문자열 필수 사항
  
  Organization_id 문자열 필수 사항
- can_manage_deployments 부울
- created_at 문자열
- description 문자열
- id 문자열
- 이름 문자열
- org_id 문자열
- 공유 정책 객체
  
  공유 정책 속성 숨기기 공유 정책 속성 표시 객체
  
  허용된 소스 array[string]
  
  Share_modes array[string]
  
  공유 가능 부울
- source 문자열
  
  값은 atlas 또는 agent_engine입니다.
- updated_at 문자열
- Workspace_count integer
  
  WorkspaceCount는 프로젝트 에서 삭제되지 않은 작업 공간의 수입니다. 목록 응답에 포함되고 단일 프로젝트 GET에서는 생략됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- allow_member_invites 부울
- Atlas 객체
  
  Atlas 속성 숨기기 Atlas 속성 표시 객체
  
  환경 문자열 필수 사항
  
  id 문자열 필수 사항
  
  Organization_id 문자열 필수 사항
- can_manage_deployments 부울
- created_at 문자열
- description 문자열
- id 문자열
- 이름 문자열
- org_id 문자열
- 공유 정책 객체
  
  공유 정책 속성 숨기기 공유 정책 속성 표시 객체
  
  허용된 소스 array[string]
  
  Share_modes array[string]
  
  공유 가능 부울
- source 문자열
  
  값은 atlas 또는 agent_engine입니다.
- updated_at 문자열
- Workspace_count integer
  
  WorkspaceCount는 프로젝트 에서 삭제되지 않은 작업 공간의 수입니다. 목록 응답에 포함되고 단일 프로젝트 GET에서는 생략됩니다.
400

application/json

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

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

application/json

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

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

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

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

ATLAS_PAYMENT_METHOD_REQUIRED
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- 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 부울
500

application/json

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

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

application/json

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

잘못된 게이트웨이
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
503

application/json

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

서비스를 사용할 수 없음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

POST /api/v1/orgs/{orgId}/projects

curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/orgs/{orgId}/projects' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "allow_member_invites": true,
  "description": "string",
  "name": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  }
}'

요청 예시

{
  "allow_member_invites": true,
  "description": "string",
  "name": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  }
}

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

{
  "allow_member_invites": true,
  "atlas": {
    "environment": "string",
    "id": "string",
    "organization_id": "string"
  },
  "can_manage_deployments": true,
  "created_at": "string",
  "description": "string",
  "id": "string",
  "name": "string",
  "org_id": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  },
  "source": "atlas",
  "updated_at": "string",
  "workspace_count": 42
}

응답 예시(201)

{
  "allow_member_invites": true,
  "atlas": {
    "environment": "string",
    "id": "string",
    "organization_id": "string"
  },
  "can_manage_deployments": true,
  "created_at": "string",
  "description": "string",
  "id": "string",
  "name": "string",
  "org_id": "string",
  "sharing_policy": {
    "allowed_sources": [
      "string"
    ],
    "share_modes": [
      "string"
    ],
    "shareable": true
  },
  "source": "atlas",
  "updated_at": "string",
  "workspace_count": 42
}

응답 예시(400)

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

응답 예시(400)

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

응답 예시(401)

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

응답 예시(401)

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

응답 예시(402)

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

응답 예시(402)

{
  "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
}

응답 예시(500)

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

응답 예시(500)

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

응답 예시(502)

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

응답 예시(502)

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

응답 예시(503)

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

응답 예시(503)

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