프로젝트 에 효과적인 플랫폼 정책 나열

얻다 /api/v1/projects/{id}/poliencies/Effective

베어러 인증

프로젝트 에 대해 해결된 각 정책 유형(병합된 유효 값, 각 범위의 자체 값, 시행 중인 범위)을 반환합니다. 조직 값은 서버 측에서 읽기 때문에 호출자는 프로젝트 읽기 액세스 만 필요합니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

응답

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

확인
응답 속성 숨기기 응답 속성 표시 객체
- 정책 배열[객체]
  
  정책 속성 숨기기 정책 속성 표시 객체
  
  유효_int_value integer
  
  효과적인 문자열 목록 array[string]
  
  시행된 허용 목록입니다. 빈 배열 은 아무 것도 허용되지 않는다는 의미이며, 이는 조직과 프로젝트 목록이 서로 연결되지 않을 때 발생합니다. null은 허용 목록이 적용되지 않음을 의미합니다. 이 둘은 서로 무너지지 않아야 합니다.
  
  활성화됨 부울
  
  조직 객체
  
  조직 속성 숨기기 조직 속성 표시 객체
  
  활성화됨 부울
  
  int_value integer
  
  string_list array[string]
  
  프로젝트 객체
  
  프로젝트 속성 숨기기 프로젝트 속성 표시 객체
  
  활성화됨 부울
  
  id 문자열
  
  int_value integer
  
  string_list array[string]
  
  source 문자열
  
  조직 | 프로젝트 | 둘 다 | 없음
  
  유형 문자열
  
  값은 MAX_TOOL_CALLS_PER_EXECUTION, MAX_LLM_CALLS_PER_EXECUTION, MAX_EXECUTION_DURATION_MS, MAX_TOKENS_PER_EXECUTION, MAX_TOKENS_PER_SESSION, AUTHORIZED_TOOLS 또는 AUTHORIZED_MODELS입니다.
응답 속성 숨기기 응답 속성 표시 객체
- 정책 배열[객체]
  
  정책 속성 숨기기 정책 속성 표시 객체
  
  유효_int_value integer
  
  효과적인 문자열 목록 array[string]
  
  시행된 허용 목록입니다. 빈 배열 은 아무 것도 허용되지 않는다는 의미이며, 이는 조직과 프로젝트 목록이 서로 연결되지 않을 때 발생합니다. null은 허용 목록이 적용되지 않음을 의미합니다. 이 둘은 서로 무너지지 않아야 합니다.
  
  활성화됨 부울
  
  조직 객체
  
  조직 속성 숨기기 조직 속성 표시 객체
  
  활성화됨 부울
  
  int_value integer
  
  string_list array[string]
  
  프로젝트 객체
  
  프로젝트 속성 숨기기 프로젝트 속성 표시 객체
  
  활성화됨 부울
  
  id 문자열
  
  int_value integer
  
  string_list array[string]
  
  source 문자열
  
  조직 | 프로젝트 | 둘 다 | 없음
  
  유형 문자열
  
  값은 MAX_TOOL_CALLS_PER_EXECUTION, MAX_LLM_CALLS_PER_EXECUTION, MAX_EXECUTION_DURATION_MS, MAX_TOKENS_PER_EXECUTION, MAX_TOKENS_PER_SESSION, AUTHORIZED_TOOLS 또는 AUTHORIZED_MODELS입니다.
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 부울
500

application/json

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

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

GET /api/v1/projects/{id}/poliencies/Effective

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/policies/effective' \
 --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)

{
  "policies": [
    {
      "effective_int_value": 42,
      "effective_string_list": [
        "string"
      ],
      "enabled": true,
      "organization": {
        "enabled": true,
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "project": {
        "enabled": true,
        "id": "string",
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "source": "string",
      "type": "MAX_TOOL_CALLS_PER_EXECUTION"
    }
  ]
}

응답 예시(200)

{
  "policies": [
    {
      "effective_int_value": 42,
      "effective_string_list": [
        "string"
      ],
      "enabled": true,
      "organization": {
        "enabled": true,
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "project": {
        "enabled": true,
        "id": "string",
        "int_value": 42,
        "string_list": [
          "string"
        ]
      },
      "source": "string",
      "type": "MAX_TOOL_CALLS_PER_EXECUTION"
    }
  ]
}

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

응답 예시(500)

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

응답 예시(500)

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