작업 공간 업데이트

패치 /api/v1/projects/{id}/workspaces/{workspace_id}
베어러 인증

작업 공간을 부분적으로 업데이트합니다. 프로젝트 범위는 경로 ID 경로 매개변수에 의해 전달됩니다. 필드 전용 패치는 204을 반환합니다. 상태 전용 패치(일시 중지/재개)는 다른 필드와 상호 배타적이며 ECP의 앱 본문(모든 warnings 포함)과 함께 200를 반환합니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

  • Workspace_id 문자열 필수 사항

    작업 공간 ID

application/json

body 필수 사항

업데이트 할 필드

  • 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 문자열
      • 이름 문자열
    • 요약 문자열
  • auto_deploy 부울

    AutoDeploy는 앱 수준 ECP 필드 입니다(게이트웨이 DB에 유지되지 않음). ECP의 앱 PATCH에 그대로 전달됩니다.

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

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

    • use_custom_parser 부울

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

  • 프레임워크 문자열
  • gitops 객체
    gitops 속성 숨기기 gitops 속성 표시 객체
    • 호환성 테스트 업데이트 문자열
    • connection_ref 문자열
    • 매니페스트_경로 문자열
    • provider 문자열
    • repo_url 문자열
  • 이름 문자열
  • release_mode 문자열

    ReleaseMode는 앱 수준 ECP 필드 ( 게이트웨이 DB에 유지되지 않음)입니다. ECP의 앱 PATCH에 그대로 전달됩니다. 웹훅 트리거 빌드만 제어 — API 트리거 릴리스는 모든 모드 에서 사용할 수 있습니다.

  • 상태 문자열

    상태는 일시 중지/재개 신호("활성" | "일시 중지됨")입니다. 게이트웨이는 이를 로컬에 유지하지 않습니다. 핸들러는 상태 전용 패치를 ECP로 바로 전달하고, ECP는 pause-teardown / resume-redeploy를 실행합니다.

  • 하위 디렉토리 문자열
  • Workspace_name 문자열

응답

  • 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

    상태 전용 패치의 경우 반환됩니다. ECP에서 프록시됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • app_id 문자열
    • org_id 문자열
    • PROJECT_ID 문자열
    • 상태 문자열
    • 경고 array[string]
    응답 속성 숨기기 응답 속성 표시 객체
    • app_id 문자열
    • org_id 문자열
    • PROJECT_ID 문자열
    • 상태 문자열
    • 경고 array[string]
  • 204

    필드 업데이트 패치를 위해 반환됩니다.

  • 400

    잘못된 요청

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

    찾을 수 없습니다.

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

    엔터티가 너무 큼 요청

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

    요청이 너무 많음

    헤더 속성 숨기기 헤더 속성 표시
    • 재시도 후 문자열

      재시도 전 대기 시간(초)

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

    내부 서버 오류

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

    ECP 전송 또는 일시 중지-테어다운 실패.

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

    서비스를 사용할 수 없음

    헤더 속성 숨기기 헤더 속성 표시
    • 재시도 후 문자열

      재시도 전 대기 시간(초)

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
PATCH /api/v1/projects/{id}/workspaces/{workspace_id} 
curl \
 --request PATCH 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "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"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "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"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "string"
}
응답 예시(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) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}
응답 예시(200) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "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
}
응답 예시(413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(413) 
{
  "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
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "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
}