AxHub/Docs

REST API

OpenAPI 자동 생성. Bearer token 인증, 60+ 엔드포인트.

Phase 8에서 OpenAPI snapshot + Redoc embed로 교체 예정. 현재는 개요만.

인증

Terminal
curl -H "Authorization: Bearer $AX_TOKEN" \
  https://api.axhub.dev/v1/deployments

PAT(Personal Access Token)는 대시보드 → Settings → Tokens에서 발급.

리소스

  • /v1/deployments — 배포 CRUD
  • /v1/domains — 도메인 관리
  • /v1/members — RBAC
  • /v1/secrets — Secret Manager
  • /v1/logs — 로그 스트림
  • /v1/cost — 비용 조회

페이지네이션

?cursor=eyJp...&limit=50

응답에 next_cursor 필드.

에러 포맷

response.json
{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "PAT에 write:deploy 권한이 필요합니다",
    "docs_url": "/docs/mcp/auth#scopes"
  }
}