환경 목록

러너 환경의 베이스 이미지, Xcode 버전, 시뮬레이터 런타임, 상태를 돌려줍니다

GET /v1/environments

인증

방식	허용	조건
API 키 (`Authorization: Bearer xci_live_…`)	가능	키 권한 `read` (run 키도 가능)
콘솔 세션 쿠키	가능	조직 역할 `owner`, `admin`, `developer`

매개변수

이름	위치	타입	필수	설명
`workspace_id`	쿼리	string		콘솔 세션은 워크스페이스가 필요한 곳에서 필수, API 키는 생략하거나 키의 워크스페이스와 같아야 합니다

응답

200

필드	타입	항상	설명
`data`	array<object>	항상	항목 배열
`data[].id`	string	항상	macos-m4, SKU 하나
`data[].name`	string	항상	이름
`data[].runner`	object		vCPU, 메모리(GB), 칩
`data[].runner.vcpu`	integer		vCPU 수
`data[].runner.ram_gb`	integer		메모리(GB)
`data[].runner.chip`	string		칩
`data[].base_image`	object		베이스 이미지 이름, 버전, macOS 버전
`data[].base_image.name`	string		이름
`data[].base_image.version`	string		버전, null 가능
`data[].base_image.macos_version`	string		macOS 버전, null 가능
`data[].xcodes`	array<object>	항상	고를 수 있는 Xcode 버전과 기본값 표시
`data[].xcodes[].version`	string	항상	버전
`data[].xcodes[].default`	boolean	항상	기본값인지
`data[].simulator_runtimes`	array<string>	항상	설치된 시뮬레이터 런타임
`data[].status`	`available` \| `busy` \| `unavailable`	항상	available은 지금 빈 슬롯이 있음, busy는 모든 슬롯 사용 중(잡은 대기), unavailable은 러너 없음
`workspace_default`	string		workspace_id를 줬거나 API 키로 부를 때만

{
  "data": [
    {
      "id": "macos-m4",
      "name": "macOS 러너",
      "runner": {
        "vcpu": 4,
        "ram_gb": 7,
        "chip": "Apple M4"
      },
      "base_image": {
        "name": "macos-xcode",
        "version": "27.0",
        "macos_version": "26"
      },
      "xcodes": [
        {
          "version": "27.0",
          "default": true
        },
        {
          "version": "26.6",
          "default": false
        }
      ],
      "simulator_runtimes": [
        "iOS 26.0"
      ],
      "status": "available"
    }
  ],
  "workspace_default": "…"
}

오류

HTTP	코드	다시 시도	뜻
400	`invalid_request`	아니오	본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
401	`api_key_required`	아니오	API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다
401	`api_key_revoked_leaked`	아니오	공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요
401	`invalid_api_key`	아니오	모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함)
401	`session_required`	아니오	콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
403	`insufficient_permission`	아니오	역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
404	`not_found`	아니오	자원이 없거나 이 호출자에게 보이지 않습니다
429	`rate_limited`	가능	이 키 또는 조직의 요청이 너무 많습니다, retryafters만큼 기다리세요
500	`internal_error`	가능	예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요

오류 봉투 모양과 전체 코드 표는 오류 코드에 있습니다

예시

curl "https://xenoci.com/api/runner/v1/environments" \
  -H "Authorization: Bearer $XENOCI_API_KEY"

다음 단계

워크스페이스 기본 환경 PUT /v1/organizations/{orgid}/workspaces/{workspaceid}/environment