REST API リファレンス

Base URL

https://nolto.app

認証

API リクエストには Authorization ヘッダーで Personal API Token を渡します:

Authorization: Bearer nolto_user_xxxxxx

詳しくは 認証 を参照してください。

エラーレスポンス

エラー時は以下の形式で JSON が返ります:

{
  "error": "エラーメッセージ"
}

クォータ超過（402）の場合は追加フィールドが含まれます:

{
  "error": "...",
  "message": "...",
  "upgradeUrl": "/settings/billing"
}

Projects

レスポンス:

{
  "projects": [
    {
      "id": "uuid",
      "name": "プロジェクト名",
      "description": "説明",
      "repository_url": "https://...",
      "updated_at": "2026-05-20T...",
      "role": "owner",
      "plans": [...]
    }
  ]
}

リクエスト:

{
  "name": "my-app",
  "description": "メインのWebアプリ",
  "repositoryUrl": "https://github.com/..."
}

リクエスト:

{
  "accentColor": "#e4002b"
}

Members

リクエスト:

{
  "email": "user@example.com",
  "role": "member"
}

ユーザーが既に Nolto アカウントを持っている場合は即座にメンバーに追加されます。持っていない場合は招待メールが送信されます。

リクエスト:

{
  "role": "member"
}

Invitations

Plans

クエリパラメータ:

リクエストの詳細は プランの登録・管理 を参照してください。

レスポンス:

{
  "planId": "uuid",
  "transformStatus": "queued",
  "detailUrl": "https://nolto.app/projects/.../plans/..."
}

リクエスト:

{
  "status": "done",
  "message": "全タスク完了"
}

許可されていない遷移をリクエストすると 400 が返ります。遷移ルールは データモデル を参照してください。

レスポンス:

{
  "jobId": "uuid",
  "transformStatus": "queued"
}

リクエスト:

{
  "userId": "uuid"
}

Phases

リクエスト:

{
  "status": "done",
  "message": "完了"
}

レスポンス:

{
  "ok": true,
  "planStatus": "in_progress"
}

planStatus は再計算後の親プランのステータスです。

Tokens

リクエスト:

{
  "name": "CI用トークン",
  "expiresAt": "2026-12-31T23:59:59Z"
}

レスポンスの token フィールドにトークン文字列が含まれます。この値は作成時に一度だけ返されます。

Usage

Billing

レスポンス:

{
  "url": "https://checkout.stripe.com/..."
}