작업 공간 가져오기

얻다 /api/v1/projects/{id}/workspaces/{workspace_id}

베어러 인증

ID 로 단일 작업 공간을 검색합니다. 프로젝트 범위는 경로 ID 경로 매개변수에 의해 전달됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID
Workspace_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

확인
응답 속성 숨기기 응답 속성 표시 객체
- 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 문자열
응답 속성 숨기기 응답 속성 표시 객체
- 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

application/json

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

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

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/projects/{id}/workspaces/{workspace_id}

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

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

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

응답 예시(404)

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

응답 예시(404)

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

응답 예시(500)

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

응답 예시(500)

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