작업 공간 나열

얻다 /api/v1/projects/{id}/workspaces
베어러 인증

경로 ID 경로 매개변수로 식별되는 프로젝트 의 모든 작업 공간을 반환합니다. 유효한 무기명 토큰과 프로젝트 역할 필요합니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

응답

  • 406

    지원되지 않거나 잘못된 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

    확인

    응답 속성 숨기기 응답 속성 표시 객체
    • 합계 integer
    • 작업 공간 배열[객체]
      작업 공간 속성 숨기기 작업 공간 속성 표시 객체
      • aer_http_endpoint 문자열

        AERHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트의 레거시 이름입니다.

      • Agent_card 객체
        Agent_card 속성 숨기기 Agent_card 속성 표시 객체
        • a2a_allowed_callers array[string]

          A2AAllowedCallers는 A2A를 통해 이 에이전트 호출할 수 있는 작업 공간 ID를 제한합니다. 목록이 비어 있으면 모든 발신자가 허용됩니다.

        • a2a_enabled 부울

          A2AEnabled는 이 에이전트 A2A 호출에 대해 검색할 수 있는지 여부를 제어합니다.

        • 기능 array[string]
        • input_modes array[string]

          입력 모드는 에이전트 허용하는 MIME 유형을 나열합니다(예: 'text/플레인', ' 애플리케이션/json').

        • output_modes array[string]

          출력 모드는 에이전트 생성할 수 있는 MIME 유형을 나열합니다.

        • 기술 배열[객체]

          스킬은 에이전트 이 수행할 수 있는 개별 작업을 광고합니다.

          스킬 속성 숨기기 스킬 속성 표시 객체
          • description 문자열
          • example_input 문자열
          • example_output 문자열
          • 이름 문자열
        • 요약 문자열
      • agent_grpc_endpoint 문자열
      • agent_http_endpoint 문자열

        AgentHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트입니다. aer_http_endpoint와 동일한 값입니다.

      • auto_deploy 부울

        AutoDeploy는 ECP가 소유한 앱별 자동 배포 토글입니다. ECP가 소유하며 각 세부 정보 GET에서 가져옵니다(게이트웨이 DB에 유지되지 않음). ECP에 값이 없거나 연결할 수 없는 경우에는 부재합니다. UI 부재를 해제로 처리합니다.

      • Completion_rate 숫자
      • created_date 문자열
      • current_deployment_id 문자열
      • current_payload_ref 문자열
      • description 문자열
      • 기능 객체
        기능 속성 숨기기 기능 속성 표시 객체
        • 가드 레일 부울
        • 메모리 부울
        • 놀이터 부울

          플레이그라운드는 작업 공간에 플레이그라운드 UI 프로비저닝되었는지 여부를 보고합니다(nil/true = 프로비저닝됨, 오늘의 동작). false인 경우 호출자는 호출 API 직접 사용합니다.

        • use_custom_parser 부울

          UseCustomParser가 true인 경우, 게이트웨이가 호출 스트림 에서 에이전트의 출력 구문 분석기 사용자 지정 이벤트만 내보내도록 합니다(플랫폼 프레임 삭제). Agentengine init의 에이전트.yaml 기능에서 유지됩니다.

      • 프레임워크 문자열
      • github_installation_id integer

        Github 설치 ID는 리포지토리를 소유하는 GitHub 앱 설치입니다. ECP가 소유하고 각 세부 정보 GET에서 가져오므로(게이트웨이 DB에 유지되지 않음) 이 필드 존재하기 전에 생성된 작업 공간에서 작동합니다. UI 추적된 브랜치를 편집할 때 리포지토리의 브랜치를 나열하는 데 필요합니다.

      • gitops 객체
        gitops 속성 숨기기 gitops 속성 표시 객체
        • 호환성 테스트 업데이트 문자열
        • connection_ref 문자열
        • github_installation_id integer(int64)
        • 매니페스트_경로 문자열
        • provider 문자열
        • repo_url 문자열
      • id 문자열
      • 인스턴스 객체

        인스턴스는 작업 공간의 인스턴스 수(활성, 대기 및 시작)와 작업 공간의 OE 셀에서 가져온 읽기 시간을 보고합니다. OE에 연결할 수 없거나 작업 공간이 풀링 실행 되지 않는 경우(예: 컨테이너 모드) 부재합니다. 의도적으로 내부 구현 이름 지정이 없습니다: 이 필드는 고객을 대상으로 하는 필드 입니다.

        인스턴스 속성 숨기기 인스턴스 속성 표시 객체
        • 활성 integer
        • 풀링 부울
        • standby integer
        • 시작 integer
      • 호출 integer

        롤링 24h 창 에 대한 실행 지표 . 5개의 필드가 모두 포인터이므로 와이어는 UI 다르게 렌더링해야 하는 두 가지 경우를 구별할 수 있습니다: (a) OE 지표 가져오기 실패(소프트 실패 - 5개 필드 모두 없음), 또는 (b) 창 에 호출이 0개/완료되지 않음 실행(호출이 0로 설정하다 되고 지연 시간/rate 필드가 없음). UI 는 " from "0 호출" 호출을 통해 != nil.

      • 언어 문자열
      • last_invoked_at 문자열(날짜-시간)
      • metrics_computed_at 문자열(날짜-시간)
      • metrics_window_start 문자열(날짜-시간)
      • 이름 문자열
      • org_id 문자열
      • p95_latency_ms 숫자
      • PROJECT_ID 문자열
      • release_mode 문자열

        ReleaseMode는 ECP가 소유한 웹훅 출시하다 정책('push' | "tag-release" | "api-only")입니다. 각 세부 정보 GET에서 가져옵니다. ECP에 값이 없거나 연결할 수 없는 경우에는 없습니다.

      • 상태 문자열

        상태는 ECP가 소유한 활성/일시 중지 신호입니다. 게이트웨이는 각 세부 정보 GET 시 ECP에서 가져오며, 이는 로컬에 유지되지 않습니다. ECP에 연결할 수 없는 경우에는 부재합니다. UI 부재를 일시 중지되지 않은 것으로 처리합니다.

        값은 active, paused, error, disconnected 또는 deleting입니다.

      • 하위 디렉토리 문자열
      • updated_date 문자열
      • Workspace_id 문자열
      • Workspace_name 문자열
    응답 속성 숨기기 응답 속성 표시 객체
    • 합계 integer
    • 작업 공간 배열[객체]
      작업 공간 속성 숨기기 작업 공간 속성 표시 객체
      • aer_http_endpoint 문자열

        AERHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트의 레거시 이름입니다.

      • Agent_card 객체
        Agent_card 속성 숨기기 Agent_card 속성 표시 객체
        • a2a_allowed_callers array[string]

          A2AAllowedCallers는 A2A를 통해 이 에이전트 호출할 수 있는 작업 공간 ID를 제한합니다. 목록이 비어 있으면 모든 발신자가 허용됩니다.

        • a2a_enabled 부울

          A2AEnabled는 이 에이전트 A2A 호출에 대해 검색할 수 있는지 여부를 제어합니다.

        • 기능 array[string]
        • input_modes array[string]

          입력 모드는 에이전트 허용하는 MIME 유형을 나열합니다(예: 'text/플레인', ' 애플리케이션/json').

        • output_modes array[string]

          출력 모드는 에이전트 생성할 수 있는 MIME 유형을 나열합니다.

        • 기술 배열[객체]

          스킬은 에이전트 이 수행할 수 있는 개별 작업을 광고합니다.

          스킬 속성 숨기기 스킬 속성 표시 객체
          • description 문자열
          • example_input 문자열
          • example_output 문자열
          • 이름 문자열
        • 요약 문자열
      • agent_grpc_endpoint 문자열
      • agent_http_endpoint 문자열

        AgentHTTPEndpoint는 에이전트 샌드박스 HTTP 엔드포인트입니다. aer_http_endpoint와 동일한 값입니다.

      • auto_deploy 부울

        AutoDeploy는 ECP가 소유한 앱별 자동 배포 토글입니다. ECP가 소유하며 각 세부 정보 GET에서 가져옵니다(게이트웨이 DB에 유지되지 않음). ECP에 값이 없거나 연결할 수 없는 경우에는 부재합니다. UI 부재를 해제로 처리합니다.

      • Completion_rate 숫자
      • created_date 문자열
      • current_deployment_id 문자열
      • current_payload_ref 문자열
      • description 문자열
      • 기능 객체
        기능 속성 숨기기 기능 속성 표시 객체
        • 가드 레일 부울
        • 메모리 부울
        • 놀이터 부울

          플레이그라운드는 작업 공간에 플레이그라운드 UI 프로비저닝되었는지 여부를 보고합니다(nil/true = 프로비저닝됨, 오늘의 동작). false인 경우 호출자는 호출 API 직접 사용합니다.

        • use_custom_parser 부울

          UseCustomParser가 true인 경우, 게이트웨이가 호출 스트림 에서 에이전트의 출력 구문 분석기 사용자 지정 이벤트만 내보내도록 합니다(플랫폼 프레임 삭제). Agentengine init의 에이전트.yaml 기능에서 유지됩니다.

      • 프레임워크 문자열
      • github_installation_id integer

        Github 설치 ID는 리포지토리를 소유하는 GitHub 앱 설치입니다. ECP가 소유하고 각 세부 정보 GET에서 가져오므로(게이트웨이 DB에 유지되지 않음) 이 필드 존재하기 전에 생성된 작업 공간에서 작동합니다. UI 추적된 브랜치를 편집할 때 리포지토리의 브랜치를 나열하는 데 필요합니다.

      • gitops 객체
        gitops 속성 숨기기 gitops 속성 표시 객체
        • 호환성 테스트 업데이트 문자열
        • connection_ref 문자열
        • github_installation_id integer(int64)
        • 매니페스트_경로 문자열
        • provider 문자열
        • repo_url 문자열
      • id 문자열
      • 인스턴스 객체

        인스턴스는 작업 공간의 인스턴스 수(활성, 대기 및 시작)와 작업 공간의 OE 셀에서 가져온 읽기 시간을 보고합니다. OE에 연결할 수 없거나 작업 공간이 풀링 실행 되지 않는 경우(예: 컨테이너 모드) 부재합니다. 의도적으로 내부 구현 이름 지정이 없습니다: 이 필드는 고객을 대상으로 하는 필드 입니다.

        인스턴스 속성 숨기기 인스턴스 속성 표시 객체
        • 활성 integer
        • 풀링 부울
        • standby integer
        • 시작 integer
      • 호출 integer

        롤링 24h 창 에 대한 실행 지표 . 5개의 필드가 모두 포인터이므로 와이어는 UI 다르게 렌더링해야 하는 두 가지 경우를 구별할 수 있습니다: (a) OE 지표 가져오기 실패(소프트 실패 - 5개 필드 모두 없음), 또는 (b) 창 에 호출이 0개/완료되지 않음 실행(호출이 0로 설정하다 되고 지연 시간/rate 필드가 없음). UI 는 " from "0 호출" 호출을 통해 != nil.

      • 언어 문자열
      • last_invoked_at 문자열(날짜-시간)
      • metrics_computed_at 문자열(날짜-시간)
      • metrics_window_start 문자열(날짜-시간)
      • 이름 문자열
      • org_id 문자열
      • p95_latency_ms 숫자
      • PROJECT_ID 문자열
      • release_mode 문자열

        ReleaseMode는 ECP가 소유한 웹훅 출시하다 정책('push' | "tag-release" | "api-only")입니다. 각 세부 정보 GET에서 가져옵니다. ECP에 값이 없거나 연결할 수 없는 경우에는 없습니다.

      • 상태 문자열

        상태는 ECP가 소유한 활성/일시 중지 신호입니다. 게이트웨이는 각 세부 정보 GET 시 ECP에서 가져오며, 이는 로컬에 유지되지 않습니다. ECP에 연결할 수 없는 경우에는 부재합니다. UI 부재를 일시 중지되지 않은 것으로 처리합니다.

        값은 active, paused, error, disconnected 또는 deleting입니다.

      • 하위 디렉토리 문자열
      • updated_date 문자열
      • Workspace_id 문자열
      • Workspace_name 문자열
  • 400

    잘못된 요청

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

    승인되지 않음

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

    내부 서버 오류

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
GET /api/v1/projects/{id}/workspaces 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces' \
 --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) 
{
  "total": 42,
  "workspaces": [
    {
      "aer_http_endpoint": "string",
      "agent_card": {
        "a2a_allowed_callers": [
          "string"
        ],
        "a2a_enabled": true,
        "capabilities": [
          "string"
        ],
        "input_modes": [
          "string"
        ],
        "output_modes": [
          "string"
        ],
        "skills": [
          {
            "description": "string",
            "example_input": "string",
            "example_output": "string",
            "name": "string"
          }
        ],
        "summary": "string"
      },
      "agent_grpc_endpoint": "string",
      "agent_http_endpoint": "string",
      "auto_deploy": true,
      "completion_rate": 42.0,
      "created_date": "string",
      "current_deployment_id": "string",
      "current_payload_ref": "string",
      "description": "string",
      "features": {
        "guardrails": true,
        "memory": true,
        "playground": true,
        "use_custom_parser": true
      },
      "framework": "string",
      "github_installation_id": 42,
      "gitops": {
        "branch": "string",
        "connection_ref": "string",
        "github_installation_id": 42,
        "manifest_path": "string",
        "provider": "string",
        "repo_url": "string"
      },
      "id": "string",
      "instances": {
        "active": 42,
        "pooled": true,
        "standby": 42,
        "starting": 42
      },
      "invocations": 42,
      "language": "string",
      "last_invoked_at": "2026-05-04T09:42:00Z",
      "metrics_computed_at": "2026-05-04T09:42:00Z",
      "metrics_window_start": "2026-05-04T09:42:00Z",
      "name": "string",
      "org_id": "string",
      "p95_latency_ms": 42.0,
      "project_id": "string",
      "release_mode": "string",
      "status": "active",
      "subdirectory": "string",
      "updated_date": "string",
      "workspace_id": "string",
      "workspace_name": "string"
    }
  ]
}
응답 예시(200) 
{
  "total": 42,
  "workspaces": [
    {
      "aer_http_endpoint": "string",
      "agent_card": {
        "a2a_allowed_callers": [
          "string"
        ],
        "a2a_enabled": true,
        "capabilities": [
          "string"
        ],
        "input_modes": [
          "string"
        ],
        "output_modes": [
          "string"
        ],
        "skills": [
          {
            "description": "string",
            "example_input": "string",
            "example_output": "string",
            "name": "string"
          }
        ],
        "summary": "string"
      },
      "agent_grpc_endpoint": "string",
      "agent_http_endpoint": "string",
      "auto_deploy": true,
      "completion_rate": 42.0,
      "created_date": "string",
      "current_deployment_id": "string",
      "current_payload_ref": "string",
      "description": "string",
      "features": {
        "guardrails": true,
        "memory": true,
        "playground": true,
        "use_custom_parser": true
      },
      "framework": "string",
      "github_installation_id": 42,
      "gitops": {
        "branch": "string",
        "connection_ref": "string",
        "github_installation_id": 42,
        "manifest_path": "string",
        "provider": "string",
        "repo_url": "string"
      },
      "id": "string",
      "instances": {
        "active": 42,
        "pooled": true,
        "standby": 42,
        "starting": 42
      },
      "invocations": 42,
      "language": "string",
      "last_invoked_at": "2026-05-04T09:42:00Z",
      "metrics_computed_at": "2026-05-04T09:42:00Z",
      "metrics_window_start": "2026-05-04T09:42:00Z",
      "name": "string",
      "org_id": "string",
      "p95_latency_ms": 42.0,
      "project_id": "string",
      "release_mode": "string",
      "status": "active",
      "subdirectory": "string",
      "updated_date": "string",
      "workspace_id": "string",
      "workspace_name": "string"
    }
  ]
}
응답 예시(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
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}