repos

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos

viewer 以上が必要です。

リポジトリはプロジェクトに属します。 アクセス権は org 内のロールによって管理され、リポジトリ名はプロジェクト内で一意です。1 つのプロジェクトに複数のリポジトリ（アプリ・API・インフラ）を持たせることができます。

operationId listRepos

POST /v1/orgs/{orgSlug}/projects/{projectName}/repos

member 以上が必要です。repo.create として監査記録されます。

リポジトリは直ちに登録されます。ストレージは初回アクセス時に作成されるため、リポジトリサーバーが一時的に利用できない場合でもこの呼び出しは成功します。

operationId createRepo

リクエストボディ: application/json ・ object

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}

単一のリポジトリ

operationId getRepo

PATCH /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}

管理者権限が必要です。repo.updateとして監査されます。

名前の変更はメタデータの変更のみです。名前を変更しても、進行中のプッシュが中断されることはありません。

operationId updateRepo

リクエストボディ: application/json ・ object

DELETE /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}

管理者権限が必要です。repo.deleteとして監査されます。

これはソフトデリートです。 リポジトリは URL への応答を直ちに停止しますが、保存されているコピーは保持期間の経過後に削除されるため、削除を取り消せる猶予期間があります。

operationId deleteRepo

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/ref-updates

閲覧者以上の権限が必要です。直近200件のエントリです。

これは監査ログではなく、リポジトリ自体の ref 履歴です。old は、force-push で失われたコミットを復元する際に必要になります。

operationId listRefUpdates

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/deploy-hook

viewer 以上が必要です。

configured は、一度もフックが設定されたことがない場合に false になります。これは、フックが存在していてオフになっている状態（enabled）とは異なります。フックが存在しない場合、branch にはリポジトリのデフォルトブランチが提案値として設定されます。

operationId getDeployHook

PUT /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/deploy-hook

admin 権限が必要です。一方、デプロイ自体には member 権限が必要です。

フックをオンにすると、書き込み権限を持つ誰かが今後 branch にプッシュするたびに、それは本番デプロイとなり、フックをオンにした本人として実行されます。これは恒常的な権限付与であるため、deploy スコープのトークンではフックを作成できません。

省略されたフィールドは現在の値を保持するため、スイッチとブランチを別々に送信しても、一方がもう一方をリセットすることはありません。

operationId setDeployHook

リクエストボディ: application/json ・ object

DELETE /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/deploy-hook

admin 権限が必要です。プッシュデプロイを完全にオフにします。過去のビルドは、現在も稼働しているデプロイを生成したものであるため保持されます。

operationId deleteDeployHook

POST /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/deploy

member 権限が必要です。commitSha のビルドをキューに追加します。commitSha が省略された場合は、フック対象ブランチの先端のビルドをキューに追加します。

これはプッシュによるデプロイと同じ設定を使用するため、プッシュデプロイフックがオフまたは未設定のリポジトリでは、ビルドの代わりに 409 deploy_hook_off が返されます。フックがなければ、ルートディレクトリも、デプロイを実行する主体も存在しないためです。

operationId deployRepoNow

リクエストボディ: application/json ・ object

GET /v1/orgs/{orgSlug}/projects/{projectName}/builds

viewer 以上の権限が必要です。新しい順に表示され、キュー内のビルドが先頭に表示されます。

当月のビルド時間（分）が一覧と一緒に返されるため、1 回のリクエストでビルド画面の表示に必要な情報がすべて揃います。

ログはこの一覧には含まれません。 ログは最大 1 MiB になることがあるため、/builds/{buildId}/log から個別に取得します。

operationId listBuilds

GET /v1/orgs/{orgSlug}/projects/{projectName}/builds/{buildId}

個々のビルド（runlot builds show）

operationId getBuild

GET /v1/orgs/{orgSlug}/projects/{projectName}/builds/{buildId}/log

viewer 以上の権限が必要です。JSON ではなく text/plain として返されます。これは生のビルド出力であり、クライアント側でそのまま表示できます。

上限は 1 MiB で、末尾が保持されます。失敗したビルドではエラーが末尾に現れるためです。上限が適用された場合、その旨が 1 行目に記載されます。

operationId getBuildLog

POST /v1/orgs/{orgSlug}/projects/{projectName}/builds/{buildId}/cancel

member 権限が必要です。キャンセルできるのはキュー内のビルドのみです。 すでに開始されたビルドは停止できず、20 分後に自動的に終了します。

operationId cancelBuild

GET /v1/me/ssh-keys

自分の SSH 公開鍵(runlot key list)

operationId listSSHKeys

POST /v1/me/ssh-keys

公開鍵のフィンガープリントはグローバルに一意です。 鍵そのものが識別子であるため、同じ鍵を 2 回登録することはできません。既に存在する鍵は 409 ssh_key_exists を返します。

許可される鍵種別: ed25519、ecdsa-sha2-nistp256/384/521、rsa(2048ビット以上)。DSAは拒否されます。

operationId addSSHKey

リクエストボディ: application/json ・ object

DELETE /v1/me/ssh-keys/{keyId}

即座に反映されます。 このキーは、この呼び出しが返ると同時に Git アクセスで使用できなくなります。キャッシュによる遅延はありません。

operationId deleteSSHKey

GET /v1/me/tokens

トークンの平文は保存されないため、ここで返されることはありません。

operationId listAccessTokens

POST /v1/me/tokens

平文のトークンはこのレスポンスでのみ返されます。 再度取得することはできません。

Git は HTTPS 経由で Basic 認証を送信します。ユーザー名は無視され、パスワードフィールドのトークンのみが読み取られます。プレフィックス runlot_pat_ は固定されており、リポジトリ・ログ・ペーストの中で漏洩したトークンを機械的に検出できるようになっています。

トークンは、scopes の集合・org または project の制限・有効期限という 3 つの独立した軸で絞り込めます。デフォルトの有効期限は90 日で、最大は 365 日です。noExpiry は期限のないクレデンシャルを作成する唯一の方法であり、明示的に設定する必要があります。

org または project の制限は、あなた自身のメンバーシップと照合されるため、所属していない org にトークンを固定することはできません。

operationId createAccessToken

リクエストボディ: application/json ・ object

DELETE /v1/me/tokens/{tokenId}

トークンを削除する代わりに revokedAt を設定するため、その存続期間はトークン一覧に表示され続けます。即座に反映されます — キャッシュによる遅延はありません。

operationId revokeAccessToken

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/refs

viewer 以上が必要です。

リポジトリ内のすべてのブランチとタグを、デフォルトブランチとともに一覧表示します。これはダッシュボードが使用する閲覧用 API です。クローン・フェッチ・プッシュは代わりに Git トランスポート経由で行われます。

operationId getRepoRefs

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/tree

viewer 以上が必要です。path が空の場合はリポジトリのルートになります。

ディレクトリは 1000 件のエントリで切り詰められます。 その場合、レスポンスの truncated が true になります。

リポジトリの外に出るパス（a/../..）は 404 を返します。

operationId getRepoTree

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/blob

viewer 以上が必要です。

1 MiB を超えるファイルは content を伴って返されません — tooLarge が true になり、content は空になります。バイナリファイルも content を持ちません（binary が true）。

operationId getRepoBlob

GET /v1/orgs/{orgSlug}/projects/{projectName}/repos/{repoName}/commits

viewer 以上が必要です。最大 200 件のコミットを返します。デフォルトも 200 件です。

operationId getRepoCommits