API

runlot 컨트롤 플레인의 REST API입니다. 경로 78개와 작업 107개를 제공합니다.

이 페이지의 기준 소스는 proto/openapi.yaml입니다. 문서를 빌드할 때 해당 소스에서 내용을 생성합니다.

요청 방법

모든 요청에는 Bearer 토큰이 필요합니다. runlot login으로 저장한 토큰은 ~/.runlot/credentials.json에서 확인할 수 있습니다.

curl -H "Authorization: Bearer $RUNLOT_TOKEN" \
  https://api.runlot.io/v1/orgs

API 버전은 1.0.0이고, 명세는 OpenAPI 3.1.0를 따릅니다.

실패한 응답은 모두 동일한 구조를 사용합니다. 프로그램에서는 code 값으로 처리하고, 사람이 읽는 message는 변경될 수 있으므로 분기 조건으로 사용하지 마세요. 전체 목록은 오류 코드에서 확인하세요.

{ "error": { "code": "not_found", "message": "프로젝트를 찾을 수 없습니다" } }

요청 본문과 응답의 구조는 스키마에서 확인하세요.