管理 REST API

GET /api/v1/

API バージョン この API の名前とバージョンを返します。トークンが受け付けられるか確かめるときに使います。

curl "https://end.blackall.ai/api/v1/" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/me

自分のアカウント このトークンが誰のもので、何ができるかを返します。operator は運営者ツールを使えるか（active）と、使えないときのこのアカウントの理由（refused: not_listed、token_bound、no_second_factor）です。どこから始めればよいかわからないときは、最初に呼び出してください。

curl "https://end.blackall.ai/api/v1/me" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/me', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/regions

リージョン リージョンの一覧を返します。今プロジェクトを作成できるのは、can_createがtrueのリージョンだけです。falseのリージョンは準備中のため一覧には表示されますが、まだ選べません。リージョンはプロジェクト作成時に一度だけ選び、後から変更できないため、create_projectの前に確認してください。

curl "https://end.blackall.ai/api/v1/regions" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/regions', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/regions/requests

リージョンのリクエスト まだ開いていないリージョン（can_createがfalseのリージョン）が必要であることを登録します。担当者からご連絡します。時期はお約束できません。すでに開いているリージョンはリクエストするものではありません。create_projectでそのままプロジェクトを作成してください。

curl -X POST "https://end.blackall.ai/api/v1/regions/requests" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"region":"kr"}'

const response = await fetch('https://end.blackall.ai/api/v1/regions/requests', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "region": "kr"
  }),
})
const result = await response.json()

GET /api/v1/server-sizes

サーバーサイズと料金 サーバーサイズ（メモリ）ごとのGoogle マシン、CPU、リージョン別の月額（monthly_minor）です。通貨を空にすると組織の決済通貨です。KRWはウォン（付加価値税込み）、USDはセント（決済時に税金を追加）です。included_inがproのサイズはProプランに含まれます。region_statusがplannedのリージョンは準備中のため選べません。listedがfalseならまだ販売しておらず、sizesは空です。

curl "https://end.blackall.ai/api/v1/server-sizes?region=kr&currency=KRW" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/server-sizes?region=kr&currency=KRW', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/imports/sources

取り込み元 コンソールの「他のサーバーから取り込む」と同じです。この組織に接続した取り込み元のアカウント（Supabase、Vercel、PostgreSQL）ごとに、そのプロジェクト一覧とこれまでの取り込みを返します。アカウントの接続はコンソール（connect_url）で行います。トークンをチャットに貼らないためです。

curl "https://end.blackall.ai/api/v1/imports/sources?org=value" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/imports/sources?org=value', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/imports

取り込みを開始 コンソールの [取り込みを開始] と同じです。コンソールで分割した取り込み（import）か、import_sources の connection と project から新しい取り込みを（まとまりごとに新しいプロジェクトに分けて）開始します。新しいプロジェクトを作り、元は変えません。Supabase の元は address にセッションプーラーの接続文字列が必要で、今回の実行だけに使って削除します。止まった取り込みをもう一度開始すると、終わった移す先は飛ばし、変わったものだけ移します。オーナー・管理者・開発者のみ実行できます。

curl -X POST "https://end.blackall.ai/api/v1/imports?org=value" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{}'

const response = await fetch('https://end.blackall.ai/api/v1/imports?org=value', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({}),
})
const result = await response.json()

GET /api/v1/imports/{id}

取り込みの進行状況 コンソールの取り込みの進行画面と同じです。移す先ごとに段階（スキーマ、ログインユーザー、データ、ファイル、スケジュールジョブ…）の状態と数、移さないものとその理由、確認することを返します。

curl "https://end.blackall.ai/api/v1/imports/ID?org=value" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/imports/ID?org=value', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects

プロジェクト このアカウントのプロジェクトと、それぞれのAPIアドレスを返します。status は ready（使える）、provisioning（データベースを作成中、数秒）、failed（retry_provisioning）、paused のいずれかです。

curl "https://end.blackall.ai/api/v1/projects" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects

プロジェクトの作成 データベース、ログイン、ファイルストレージを備えた新しいプロジェクトを作成します。リージョンを空にすると既定のリージョンになります。リージョンはプロジェクト作成後に変更できません。料金はどのリージョンでも同じです。組織が複数あるときは、org でどの組織に作るかを選びます（その組織のオーナー、管理者、開発者だけが、プランのプロジェクト数の範囲で作れます）。データベースは数秒後に使えるようになります。status が provisioning なら wait（秒）を渡すか、list_projects の status が ready になってからテーブルやキーを使ってください。

curl -X POST "https://end.blackall.ai/api/v1/projects?wait=0" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"my-name","region":"kr","org":"value","wait":0,"tier":"value"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects?wait=0', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "name": "my-name",
    "region": "kr",
    "org": "value",
    "wait": 0,
    "tier": "value"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}

単一のプロジェクト プロジェクト一覧のうち、この ref の項目を返します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PATCH /api/v1/projects/{ref}

名前の変更 プロジェクト名、組織名、またはその両方を変更します。識別子（ref）とアドレスは変わりません。この操作はオーナーと管理者のみ行えます。

curl -X PATCH "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"my-name","organisation":"My team"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst', {
  method: 'PATCH',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "name": "my-name",
    "organisation": "My team"
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/pause

プロジェクトの一時停止 プロジェクトのすべての動作を止めます。サイト、API、関数は503を返し、リアルタイム接続は拒否され、予約ジョブと新しいデプロイも止まります。データとファイルはそのまま残り、resume_projectですぐに元に戻せます。90 日を超えて一時停止すると、データベースをアーカイブストレージへ移します（get_project_archive）。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/pause" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/pause', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/resume

プロジェクトの再開 一時停止したプロジェクトを再び動かします。無料プランで 3 日間使われずに停止したプロジェクトもこれで（または新しいデプロイで）再開します。予約ジョブは逃した実行を取り戻さず、次の予定時刻から実行します。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/resume" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/resume', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/archive

データベースのアーカイブ状態 データベースを使えない状態（支払いの失敗、無料プラン、一時停止）が 90 日続くと、アーカイブストレージへ移します。このプロジェクトの状況を返します: state（none、scheduled、archiving、archived、restoring、purged）、reason、archive_at（移す日時）、purge_at（アーカイブとファイルを削除する日時、移してから 1 年後）、restore_blocked_by。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/archive/restore

アーカイブしたデータベースを復元 アーカイブストレージのデータベースを、アーカイブしたときのまま作り直します。通常は数分で、一時停止中のプロジェクトは復元と同時に再開します。お支払いが完了していないときや無料プランでは拒否します（restore_blocked_by）。アーカイブがすでに削除されていれば、空のデータベースを新しく作成します。オーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive/restore" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive/restore', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/archive/download

アーカイブのダウンロード用アドレス アーカイブしたデータベース（pg_dump 形式。pg_restore で復元）を 1 時間ダウンロードできる署名付きアドレスを作成します。理由が必要で、アクセス記録に残ります。オーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive/download" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"reason":"value"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/archive/download', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "reason": "value"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}

プロジェクトの削除 プロジェクトのテーブル、ユーザー、ファイル、関数、予約ジョブ、環境変数、ドメインを完全に削除します。元に戻せません。ユーザーがはっきり求めたときだけ使い、confirmにプロジェクト名を正確に入れてください。最後に残ったプロジェクトは削除できません。この操作はオーナーと管理者のみ行えます。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/retry-provisioning

準備に失敗したプロジェクトの再試行 データベースを作成できなかったプロジェクトの準備をやり直します。ほかのツールが「作成できませんでした」と拒否したときに使ってください。新しいプロジェクトは作成しないでください。これは同じプロジェクトの準備を続けるもので、新しく作ると請求が二重になるだけです。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/retry-provisioning" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/retry-provisioning', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/keys

APIキーの取得 プロジェクトのアドレスと2つのキーを返します。パブリッシャブルキーはブラウザ用です。シークレットキーはすべてのアクセスルールを迂回するため、サーバーでのみ使ってください。書き込み権限のあるトークンだけが呼び出せます。フロントエンドのコードに入れる値が必要なときは only: "publishable" で呼び出してください。アドレスとパブリッシャブルキーだけが返り、シークレットキーが会話やコードに混ざりません（読み取り権限のトークンでも呼び出せます）。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/keys?only=publishable" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/keys?only=publishable', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/api-keys

名前付きAPIキー 用途ごとに作成したbw_publishable_キーとbw_secret_キーそれぞれの名前、種類、プレフィックス、最終使用日時、失効状態です。シークレットキーの値は返しません。パブリッシャブルキーの値は返します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/api-keys

APIキーの作成 名前付きのキーを1つ作成します。publishableはブラウザ用（アクセスルールに従う）、secretはサーバー用（アクセスルールを迂回する）です。シークレットキーの値はこの応答にだけ含まれ、二度と表示できません。キーを作成できるのはオーナーと管理者のみで、プロジェクトごとに20個までです。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"kind":"publishable","name":"my-name"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "kind": "publishable",
    "name": "my-name"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/api-keys/{id}

APIキーの失効 名前付きのキーを1つ失効させます。そのキーを使ったリクエストは30秒以内に拒否されるようになります。ほかのキーには影響しません。元に戻せません。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys/ID" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/api-keys/ID', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/signing

トークンの署名 ログイントークンをHS256とES256のどちらで署名しているか、また当面まだ受け付ける古いキー（猶予期間中のキー）を表示します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/signing

トークンの署名の変更 ES256にすると、新しいログインは非対称鍵で署名され、ほかのサーバーが公開鍵（JWKS）でトークンを確認できます。すでに発行されたトークンは期限が切れるまで使えます。この操作はオーナーと管理者のみ行えます。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"alg":"HS256"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "alg": "HS256"
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/signing/rotate

キーのローテーション パブリッシャブルキーとシークレットキーに署名する新しいキーを作成します。古いキーはgrace_hours（0、1、24、168）の間まだ受け付けます。0（または空）にするとすぐに無効になります（漏えいした場合）。0のときは使っているアプリがすべて30秒以内に止まるため、confirm にプロジェクト名（list_projectsのname）をそのまま入れてください。アプリに入れたキーをすべて置き換える必要があるため、ユーザーがはっきり求めたときだけ使ってください。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing/rotate" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"grace_hours":0,"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing/rotate', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "grace_hours": 0,
    "confirm": "my-project"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/signing/keys/{kid}

古いキーの終了 猶予期間中の古いキーを今すぐ終了します。kidはget_jwt_signingのkeysのうち、stateがrotatingのものです。この操作はオーナーと管理者のみ行えます。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing/keys/KEY_ID" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/signing/keys/KEY_ID', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/advisors

セキュリティとパフォーマンスの点検 プロジェクトのデータベース構造からセキュリティとパフォーマンスの問題を探します。RLSがオフのテーブル、誰でも書き込めるルール、アクセスルールを迂回するビュー、search_pathが固定されていないsecurity definer関数、ユーザーテーブルを公開するビュー、インデックスのない外部キー、主キーのないテーブル、重複したインデックス、行ごとにuid()を呼び出すルールが対象です。修正するSQLがある項目にはそれ（remedy）を添えます。データは読みません。テーブルを作成したりルールを変更したりした後に呼び出してください。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/advisors" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/advisors', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/tables/{table}/csv

テーブルをCSVでエクスポート テーブルの行を CSV で返します（1行目は列名）。コンソールのテーブルエディターのエクスポートと同じです。1MB まで返り、超えると行の区切りで切って truncated が true になります。そのときは filters で範囲を分けて何回かに分けて受け取ってください。空欄は NULL、"" は空文字列です。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables/notes/csv?sort=value&desc=true" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables/notes/csv?sort=value&desc=true', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/tables/{table}/csv

CSVをテーブルにインポート CSV の行をテーブルに入れます。コンソールのテーブルエディターのインポートと同じです。1行目は列名で、同じ名前の列に入ります（columns で変えられます）。1行でも入れられなければ何も入れず、行番号と理由を返します。2MB、10,000行までです。引用符のない空欄は NULL か列の既定値です。それより大きいときは分けて呼び出してください。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables/notes/csv" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"csv":"value"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables/notes/csv', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "csv": "value"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/tables

テーブル プロジェクトのテーブルを、列、おおよその行数、アクセスルールの状態とともに返します。ルールがオンなのにルールが1つもない場合、パブリッシャブルキーからは何も見えません。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/tables', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/policies

アクセスルール どのテーブルのどの操作が誰に開かれているかを返します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/policies" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/policies', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/rows/{table}

テーブルの読み取り テーブルの先頭の行をそのまま読みます。確認用です。条件が必要な場合はrun_sqlを使ってください。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/rows/notes?limit=1" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/rows/notes?limit=1', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/migrations

マイグレーションの記録 apply_migrationsで適用したマイグレーションのバージョン、名前、適用時刻を古い順に返します。記録はプロジェクトのoneend_migrationsテーブルにあります。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/migrations

マイグレーションの適用 まだ適用していないマイグレーションをバージョン順に、1つずつそれぞれのトランザクションで実行し、記録します。すでに適用されたバージョンは飛ばします。1つが失敗すると、それだけを元に戻して止まり、前のものは適用されたまま残ります。スキーマを変更するときにrun_sqlの代わりにこれを使うと、同じ変更をほかのプロジェクトにもそのまま適用し直せます。supabase/migrationsのファイルをそのまま送れます: public.、auth.uid()、storage.、to authenticatedなどのSupabaseの名前はこのプロジェクトの名前に変換して実行し、translatedで返します(Supabase名の変換)。適用記録にはファイルのとおりに残ります。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"migrations":[{"version":"20260101000000","name":"my-name","sql":"select 1"}]}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "migrations": [
      {
        "version": "20260101000000",
        "name": "my-name",
        "sql": "select 1"
      }
    ]
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/migrations/{version}

マイグレーションの記録の削除 マイグレーションを1つ、適用していない状態に戻します。記録だけを削除し、そのマイグレーションが作ったものはそのまま残します。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations/20260101000000" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/migrations/20260101000000', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/schema

スキーマをSQLで プロジェクトのスキーマ（型、シーケンス、テーブルと制約、外部キー、インデックス、関数、ビュー、トリガー、RLSとルール）を作り直せるSQLとして返します。行のデータと権限は含まれません。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/schema" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/schema', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/types/typescript

TypeScriptの型を作る プロジェクトのテーブル、ビュー、関数、列挙型から、supabase-jsのcreateClient<Database>()に渡すDatabase型を作ります。スキーマを変更したあとに、もう一度呼び出してください。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/types/typescript?schema=value" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/types/typescript?schema=value', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/sql/query

SQLの照会（読み取り専用） プロジェクトのPostgreSQLデータベースで照会文1つ（SELECTなど）を読み取り専用トランザクションで実行し、結果の行を返します。データや構造を変更する文は拒否されるため、その場合はrun_sqlを使ってください。読み取り権限のトークンでも呼び出せます。Vaultのシークレットの値は開きません（vault.decrypted_secretsのdecrypted_secretは空です）。SQLの文法はPostgreSQL 16のドキュメント（https://www.postgresql.org/docs/16/sql-commands.html）に従います。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/sql/query" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"sql":"select 1"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/sql/query', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "sql": "select 1"
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/sql

SQLの実行（変更） プロジェクトのPostgreSQLデータベースでデータや構造を変更するSQL（CREATE、INSERT、UPDATE、DELETEなど）を実行し、結果の行を返します。照会だけの場合はquery_sqlを使ってください。SQLの文法はPostgreSQL 16のドキュメント（https://www.postgresql.org/docs/16/sql-commands.html）に従います。新しいテーブルはアクセスルールが自動でオンになるため、続けてルールを作成しない限り、パブリッシャブルキーからは何も見えません。ルールで使うロール名は<ref>_anon、<ref>_authenticated、<ref>_service_roleです。Supabase向けに書いたSQL(public.、auth.uid()、storage.、to authenticated)はこのプロジェクトの名前に変換して実行し、何を変換したかをtranslatedで返します(Supabase名の変換)。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/sql" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"sql":"select 1"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/sql', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "sql": "select 1"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/database

データベース接続情報 このプロジェクトのPostgreSQLに直接接続するためのアドレスを表示します。direct（5432、session: マイグレーションツールやデータベースクライアント用）とpooler（6543、transaction: サーバーレス用）です。パスワードは保存していないため、[YOUR-PASSWORD]と表示されます。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/database/password

データベースの新しいパスワード 直接接続用の新しいパスワードを作成し、一度だけ返します。古いパスワードで接続しているものは、次の接続から拒否されます。いまそのパスワードで接続しているサーバー、ジョブ、ツールは再接続のときに切れるので、confirm にプロジェクト名（list_projectsのname）をそのまま入れてください。このユーザーは行レベルセキュリティを迂回するため、サーバーにだけ置いてください。keep_for_deploys: true のときはパスワードを封印して保管し、本番のサーバー・ミドルウェア・関数が実行時に DATABASE_URL・POSTGRES_URL・DIRECT_URL を受け取ります(ビルドには渡しません)。デプロイしたコードがシークレットキーと同じくすべての行を読めるようになるので、ユーザーが望むときだけオンにしてください。これなしで作り直すと受け渡しも止まります。ユーザーが求めたときだけ使ってください。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/password" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/password', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/mysql

MySQL データベースの一覧 このプロジェクトの MySQL データベース（MariaDB 11.4）と、それぞれがどのアプリに入るか（app、null はプロジェクト全体）、状態、サイズ、プランで作れる数（max）を返します。available が false なら、このサーバーにはまだ MySQL がありません。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/mysql

MySQL データベースの作成 WordPress のように MySQL を使うアプリのために、データベースと専用ログインを作ります。通常 1 分以内に準備できます。app を指定するとそのアプリのデプロイだけが、指定しなければプロジェクトのすべてのアプリが受け取ります（プロジェクト全体用が 1 つだけのとき）。受け取るアプリのサーバーは起動時に MYSQL_URL・MYSQL_HOST・MYSQL_PORT・MYSQL_USER・MYSQL_PASSWORD・MYSQL_DATABASE と WORDPRESS_DB_HOST・WORDPRESS_DB_USER・WORDPRESS_DB_PASSWORD・WORDPRESS_DB_NAME を受け取ります（ビルドには入りません）。毎晩バックアップされます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"name":"my-name"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "name": "my-name"
  }),
})
const result = await response.json()

PATCH /api/v1/projects/{ref}/mysql/{name}

MySQL データベースをアプリにつなぐ MySQL データベースを受け取るアプリを変えます。app が null ならプロジェクト全体用になります。1 つのアプリにつなげるデータベースは 1 つだけです。動いているサーバーは再起動するか再デプロイすると変更を受け取ります。

curl -X PATCH "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"app":"owner/repo"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name', {
  method: 'PATCH',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "app": "owner/repo"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/mysql/{name}

MySQL データベースの削除 MySQL データベースとそのログイン、バックアップをすべて削除します。元に戻せないので、ユーザーがはっきり求めたときだけ使い、confirm にデータベース名をそのまま入れてください。受け取っていたアプリは次の起動から MYSQL_* の変数を受け取りません。この操作はオーナーと管理者のみ行えます。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/mysql/{name}/connection

MySQL の接続情報 MySQL データベースのアドレス、ポート、データベース名、ログイン、パスワードと、アプリが受け取る変数（variables）を返します。アドレスにはこのサーバー上のアプリからだけ届きます。パスワードは書き込み権限のトークンにだけ表示されます。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/connection" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/connection', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/mysql/{name}/backups

MySQL バックアップの一覧 MySQL データベースのバックアップ（毎晩の自動、手動で作ったもの、復元の直前のもの）と復元の記録を返します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/backups" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/backups', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/mysql/{name}/backups

MySQL を今すぐバックアップ MySQL データベースを今すぐバックアップします。プラグインの更新や大きな変更の前に作ってください。7 日間保管されます。毎晩のバックアップは別に自動で行われます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/backups" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/backups', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/mysql/{name}/restore

MySQL をバックアップから復元 MySQL データベースをバックアップした時点に戻します。その後の変更はすべてなくなるので、ユーザーがはっきり求めたときだけ使い、confirm にデータベース名をそのまま入れてください。戻す直前の状態を先にバックアップするので、undo_backup_id でもう一度復元できます。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/restore" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"backup_id":"BACKUP_ID","confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/mysql/my-name/restore', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "backup_id": "BACKUP_ID",
    "confirm": "my-project"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/extensions

データベースの拡張機能の一覧 有効にできるPostgreSQLの拡張機能（pgvectorのvector、postgis、citext、pgcryptoなど）と、それぞれがこのサーバーにあるか（available）、有効か（enabled）、バージョンを返します。拡張機能はextensionsスキーマにインストールされ、SQLではそのままvector(1536)やgeometryのように使います。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/extensions/{name}

データベースの拡張機能を有効にする 拡張機能を1つ有効にします（create extension ... with schema extensions）。埋め込み検索にはvector、地図や距離の計算にはpostgisを使います。一覧にない拡張機能は拒否されます。この操作はオーナーと管理者のみ行えます。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions/my-name" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions/my-name', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/extensions/{name}

データベースの拡張機能を無効にする 拡張機能を1つ無効にします。その拡張機能を使う列、インデックス、関数が残っていると拒否されます。同じデータベースのほかのプロジェクトが使っている場合、インストールは残り、このプロジェクトの記録だけが削除されます（note）。pg_trgmとunaccentは標準で有効なため無効にできません。confirm に拡張機能の名前をそのまま入れてください。この操作はオーナーと管理者のみ行えます。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions/my-name" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/extensions/my-name', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/database/move

専用データベースへの移行の状態 このプロジェクトが専用データベースにあるか（dedicated）、プランに含まれるか（plan_allows）、移行を依頼したか・移行中か・失敗して止まったか（stopped、last_error）を示します。size_bytesがauto_move_max_bytesより大きいと自動では移行しないため、move_to_dedicated_databaseで依頼してください。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/move" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/move', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/database/move

専用データベースへの移行 共用データベースにあるプロジェクトを、専用のデータベースへ移行するよう依頼します。コンソールの「今すぐ移行」と同じです。順番が来ると移行し、移行中は書き込みが止まり、読み取りは続きます。移行直前の状態がバックアップとして残り、失敗した場合は元の場所にそのまま残ります（止まった移行は、もう一度依頼すると再試行します）。Vaultや大きなデータベースに必要です。Proプランから含まれます。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/move" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/move', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/database/dedicated-disk

専用ディスク データベースが大きくなったプロジェクトが使う、このプロジェクトだけのディスクと Postgres を示します。サイズ（size_gb）、使用量、月額、30日間の履歴、進行中の依頼と縮小の提案（shrink）です。まだ共有ディスクにある場合は、移す基準（threshold_gb）と現在のデータベースのサイズを示します。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/database/dedicated-disk

専用ディスクに移す このプロジェクトのデータベースを専用ディスク（max(1.2 × データベース, 20GB)）に移すよう依頼します。コンソールの「専用ディスクに移す」と同じです。ディスクは作成したサイズに対して1GBあたり月 ₩1,200（75セント）で請求し、移している間は書き込みが失敗し、読み取りはできます（get_dedicated_disk の expected_downtime_seconds）。Enterprise はいつでも、ほかの有料プランは基準を超えると依頼できます。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/database/dedicated-disk/shrink

ディスクを縮小 専用ディスクを縮小します。より小さいディスク（1.2 × データベース、最小20GB）を新しく作って移し、元のディスクを削除します。7日間 25% 未満の使用が続いたディスクだけ縮小できます（get_dedicated_disk の shrink.suggested）。移している間は書き込みが失敗し、読み取りはできます。自動で縮小することはありません。この操作はオーナーと管理者のみ行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk/shrink" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/database/dedicated-disk/shrink', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/realtime

リアルタイムがオンのテーブル 変更がリアルタイムで送られるテーブルです。ここにないテーブルを購読しても何も届きません。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/realtime" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/realtime', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/realtime/{table}

テーブルのリアルタイムのオン・オフ テーブル1つの変更通知をオンまたはオフにします。通知もアクセスルールを通過する行についてだけ送られます。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/realtime/notes" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"enabled":true}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/realtime/notes', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "enabled": true
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/users

サービスのユーザー このプロジェクトを使うサービスに新規登録したユーザーです。プラットフォームのアカウントとは別です。一度に最大200人まで返り、totalが全体の人数です。has_moreがtrueならまだ続きがあるので、offsetを増やして再度呼び出してください。usersの長さを人数として扱うのは誤りです。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users?limit=1&offset=0" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users?limit=1&offset=0', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/users/{id}/links

ログインリンクの作成 メールで送られるリンクを、メールを送らずに作って返します。invite（招待。いなければユーザーを作成）、magiclink（パスワードなしのログイン）、recovery（パスワードの再設定）、signup（新規登録の確認。password が必要）です。action_link を開いた人はそのユーザーとしてログインするので、パスワードと同じです。ユーザーがはっきり求めたときだけ作り、その人にだけ渡してください。redirect_to は add_redirect_url で登録したアドレスである必要があります。シークレットキーを見られるロール（オーナー、管理者、開発者）だけが行えます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID/links" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"type":"invite"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID/links', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "type": "invite"
  }),
})
const result = await response.json()

PATCH /api/v1/projects/{ref}/users/{id}

ユーザーの変更 このプロジェクトのユーザー1人を変更します。メールアドレス、パスワード、メールの確認、利用停止とその解除、メタデータです。渡したものだけが変わります。パスワードを変えるか停止すると、その人のログインはすべて切れます。パスワードは10文字以上で、漏えいしたことのあるものは拒否されます。メタデータは既存の値にマージされます。ユーザーがはっきり求めたときだけ使ってください。

curl -X PATCH "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","password":"a-long-passphrase","email_confirm":true,"ban_duration":"value","user_metadata":{},"app_metadata":{}}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID', {
  method: 'PATCH',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "email": "[email protected]",
    "password": "a-long-passphrase",
    "email_confirm": true,
    "ban_duration": "value",
    "user_metadata": {},
    "app_metadata": {}
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/users/import

ユーザーの一括インポート 別のサービス（例: Supabase の auth.users エクスポート）のユーザーを一度に500人まで取り込みます。id と bcrypt のパスワードハッシュはそのまま保たれるため、パスワードを決め直す必要はありません。先にリスト全体を検査し、誤りのある行は番号で示して何も取り込みません。すでにあるアカウントはスキップするので、再実行しても安全です。dry_run=true なら検査のみです。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/import" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"users":[{"email":"[email protected]","id":"ID","encrypted_password":"value","email_confirmed":"value","user_metadata":"value","app_metadata":"value"}]}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/import', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "users": [
      {
        "email": "[email protected]",
        "id": "ID",
        "encrypted_password": "value",
        "email_confirmed": "value",
        "user_metadata": "value",
        "app_metadata": "value"
      }
    ]
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/users

ユーザーの追加 このプロジェクトのサービスにユーザーを1人作成します。パスワードは10文字以上が必要です。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","password":"a-long-passphrase"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "email": "[email protected]",
    "password": "a-long-passphrase"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/providers

ソーシャルログインの設定 このプロジェクトのサービスに、どのアカウントでログインできるかを表示します。プラットフォームが対応するプロバイダーをすべて返すため、まだ設定していないものはconfigured: falseと表示されます。独自に登録したプロバイダー（custom:<名前>）はその後にcustom項目（アドレス、scopes、応答フィールドの対応）と一緒に出ます。callback_urlは、プロバイダーのコンソールにそのまま貼り付けるアドレスです。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/auth/providers/{provider}

ソーシャルログインをオンにする プロバイダー1つのクライアントIDとシークレットを保存してオンにします。シークレットは封印され読み戻せず、確認できるのは末尾4文字だけです。先にプロバイダーのコンソールでアプリを作成し、list_auth_providersのcallback_urlをリダイレクト先アドレスとして登録してください。保存済みのプロバイダーのIDだけを変える場合は、client_secretを空文字列にしてください。Supabaseと同じように、providerをcustom:<名前>にすると、プラットフォームの一覧にないOAuth 2.0・OpenID Connectプロバイダーを独自に登録します（例: custom:kakao-xts）。そのときはissuer（OpenID Connectならこれだけでアドレスを埋めます）またはauthorize_url・token_url（・userinfo_url）が必要で、scopesとclaims（応答のどのフィールドがid・email・email_verified・name・avatar・phoneか、ドットでつないだパス）を指定できます。アプリからはsignInWithOAuth({ provider: "custom:<名前>" })で呼び出し、ログイン直後のセッションにprovider_tokenが一度だけ入ります。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"client_id":"CLIENT_ID","client_secret":"CLIENT_SECRET","enabled":true}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "client_id": "CLIENT_ID",
    "client_secret": "CLIENT_SECRET",
    "enabled": true
  }),
})
const result = await response.json()

PATCH /api/v1/projects/{ref}/auth/providers/{provider}

ソーシャルログインのオン・オフ プロバイダーをオフまたはオンにし、保存済みの認証情報は残します。プロバイダーの不具合の原因を調べている間に使ってください。オンに戻すときに新しいシークレットは不要です。

curl -X PATCH "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"enabled":true}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google', {
  method: 'PATCH',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "enabled": true
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/providers/{provider}

ソーシャルログインの削除 プロバイダーの設定を認証情報ごと削除します。一時的にオフにするだけならset_auth_provider_enabledを使ってください。この方法で削除した後は、シークレットを再取得する必要があります。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/providers/google', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/redirect-urls

ログイン後に戻るアドレス ログイン後に戻すことができるアドレスです。ここにないアドレスには誰も送られません。ログインはできるのにどこにも戻らない場合は、まずここを見てください。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/auth/redirect-urls

戻るアドレスの追加 許可リストにアドレスを1つ追加します。スキーム、ホスト、ポートがすべて一致する必要があり、パスは確認しません。そのためhttps://app.example.com/callbackを追加するとhttps://app.example.comとして保存されます。モバイルアプリ独自のスキーム（co.example.app://callback）も追加できます（ドットを含むスキームのみ）。応答には実際に保存されたリストが含まれます。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/hook"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "url": "https://example.com/hook"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/redirect-urls

戻るアドレスの削除 許可リストからアドレスを1つ外します。list_redirect_urlsが返したとおりに指定してください。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/hook"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/redirect-urls', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "url": "https://example.com/hook"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/sms

SMSログイン設定の確認 電話番号の認証コードログイン(signInWithOtp({ phone }))に使うSMSアカウントを確認します。プロバイダー(platform、solapi、nhn、aligo、twilio)、送信元番号、送信できる国番号、認証コードの桁数と有効時間、1時間あたりの上限です。認証情報は末尾4文字だけ表示されます。platform_availableがtrueのときだけ、プラットフォームのアカウント(1通 ₩100、韓国のみ)を選べます。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/auth/sms

SMSログインの設定 SMSアカウントを保存してオンにします。自分で契約したプロバイダーには、key・secret・account(プロバイダーによって異なります。SolapiはAPI KeyとAPI Secret、NHN CloudはApp KeyとSecret Key、AligoはAPI KeyとUser ID(account)、TwilioとTwilio VerifyはAccount SID(account)とAuth Token(secret)、MessageBirdはAccess Key(key)、TextlocalはAPI Key(key)、VonageはAPI Key(key)とAPI Secret(secret))と、事前登録した送信元(MessageBird・Textlocal・Vonageは11文字以内の送信者IDも可、Twilio VerifyはVAで始まるVerify Service SID)が必要です。電話番号の確認やテスト番号などは update_auth_config の SMS_* キーで変更します。空欄の認証情報は保存済みの値を使います。allowed_countriesは既定で82(韓国)のみです。対象外の国を入れると、海外の有料番号にSMSを送らせる詐欺の対象になります。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"provider":"platform"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "provider": "platform"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/sms

SMSログインの削除 SMSアカウントの設定を認証情報ごと削除します。以降の電話番号ログインはphone_provider_disabledで拒否されます。一時的にオフにするだけなら、set_sms_settingsにenabled: falseを渡してください。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sms', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/smtp

SMTP設定の表示 このプロジェクトの認証メール（登録確認・パスワード再設定・ログインリンク・メールアドレス変更・招待）を送るSMTPサーバーと送信者を表示します。SupabaseのSMTP Settingsと同じ項目です。パスワードは表示されず、password_hintに末尾4文字だけが出ます（8文字以上の場合）。last_errorがあれば、そのサーバーが拒否したためプラットフォームの送信アドレスから代わりに送ったということです。configuredがfalseならプラットフォームの送信アドレスを使います。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/auth/smtp

SMTP設定 認証メールをこのプロジェクトのSMTPサーバーから、指定した送信者名とアドレスで送ります。初回はsender_email、host、username、passwordが必要で、その後は変える値だけで構いません（passwordを空にすると保存済みの値を使います）。サーバーはパブリックなアドレスで、TLS（465は最初から、それ以外はSTARTTLS）を使う必要があります。拒否された場合はプラットフォームの送信アドレスから送り、理由をlast_errorに残します。保存後にtest_smtp_settingsで確認してください。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"sender_email":"value","sender_name":"value","host":"value","port":25,"username":"value","password":"a-long-passphrase","minimum_interval_seconds":0,"rate_limit_per_hour":1,"enabled":true}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "sender_email": "value",
    "sender_name": "value",
    "host": "value",
    "port": 25,
    "username": "value",
    "password": "a-long-passphrase",
    "minimum_interval_seconds": 0,
    "rate_limit_per_hour": 1,
    "enabled": true
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/smtp

SMTP設定の削除 SMTP設定をパスワードごと削除します。以降、認証メールはプラットフォームの送信アドレスから送られます。一時的に止めるにはset_smtp_settingsにenabled: falseを渡してください。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/auth/smtp/test

SMTPテストメールの送信 保存したSMTPサーバーからテストメールを1通送ります。プラットフォームからの代替送信はしないので、失敗した場合はサーバーが返した理由がそのまま表示されます。toを省くと呼び出した人のアドレスに送ります。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp/test" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"to":"https://example.com"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/smtp/test', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "to": "https://example.com"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/templates

メールテンプレートの表示 認証メール6種類（confirmation、invite、magic_link、recovery、email_change、reauthentication）の件名と本文（HTML）です。customがfalseの種類は既定の文面（リクエストの言語に合わせた韓国語・英語・日本語）を使います。typeを渡すとその1つだけを表示します。使える変数はSupabaseと同じです: {{ .ConfirmationURL }}、{{ .Token }}、{{ .TokenHash }}、{{ .SiteURL }}、{{ .Email }}、{{ .NewEmail }}、{{ .RedirectTo }}、{{ .Data.<key> }}。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/templates/{type}

メールテンプレートの表示 認証メール6種類（confirmation、invite、magic_link、recovery、email_change、reauthentication）の件名と本文（HTML）です。customがfalseの種類は既定の文面（リクエストの言語に合わせた韓国語・英語・日本語）を使います。typeを渡すとその1つだけを表示します。使える変数はSupabaseと同じです: {{ .ConfirmationURL }}、{{ .Token }}、{{ .TokenHash }}、{{ .SiteURL }}、{{ .Email }}、{{ .NewEmail }}、{{ .RedirectTo }}、{{ .Data.<key> }}。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/auth/templates/{type}

メールテンプレートの保存 1つの種類の件名と本文（HTML）を設定します。Supabaseからコピーしたテンプレートをそのまま使えます。差し込む値はHTMLエスケープされ、件名は1行である必要があります。{{ if }}などの他の構文は拒否されます。reauthenticationは保存されますが、まだ送信されません（reauthenticateは未対応）。保存前にpreview_email_templateで確認してください。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"subject":"value","body":"value"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "subject": "value",
    "body": "value"
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/templates/{type}

メールテンプレートを戻す 1つの種類のテンプレートを削除し、既定の文面（韓国語・英語・日本語）に戻します。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

POST /api/v1/projects/{ref}/auth/templates/{type}/preview

メールテンプレートのプレビュー 例の値を入れたときのメールの見た目（件名、HTML、テキスト）を返します。subjectとbodyを渡すと保存せずにその内容を、省くと保存済みのテンプレートか既定の文面を表示します。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation/preview" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"subject":"value","body":"value"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/templates/confirmation/preview', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "subject": "value",
    "body": "value"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/auth/sso

SAML SSOの確認 このプロジェクトに登録したSAML IdPとメールドメイン、IdPに入力する2つのアドレス(acs_url、entity_id)を確認します。アプリではsupabase.auth.signInWithSSO({ domain })でログインします。

curl "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sso" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sso', {
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/auth/sso/{id}

SAML SSOの削除 IdPを1つ削除します。そのIdPで作られたアカウントは残りますが、SSOではログインできなくなります。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sso/ID" \
  -H "Authorization: Bearer $ONEEND_TOKEN"

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/sso/ID', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}` },
})
const result = await response.json()

PUT /api/v1/projects/{ref}/auth/anonymous

匿名ログインのオン・オフ メールアドレスなしですぐにセッションを発行する匿名ログインをオンまたはオフにします。今の状態はlist_auth_providersのanonymous_sign_inです。

curl -X PUT "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/anonymous" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"enabled":true}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/auth/anonymous', {
  method: 'PUT',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "enabled": true
  }),
})
const result = await response.json()

DELETE /api/v1/projects/{ref}/users/{id}

ユーザーの削除 プロジェクトのユーザーを1人削除します。元に戻せません。idはlist_usersが返した値です。ユーザーがはっきり求めたときだけ使い、confirm にそのユーザーのメールアドレス（またはid）をそのまま入れてください。

curl -X DELETE "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/users/ID', {
  method: 'DELETE',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

POST /api/v1/projects/{ref}/buckets/{bucket}/empty

バケットを空にする バケット内のファイルをすべて削除します。バケットは残ります。元に戻せないので、ユーザーがはっきり求めたときだけ使い、confirm にバケット名をそのまま入れてください。removed が削除したファイル数です。

curl -X POST "https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/buckets/value/empty" \
  -H "Authorization: Bearer $ONEEND_TOKEN" \
  -H "content-type: application/json" \
  -d '{"confirm":"my-project"}'

const response = await fetch('https://end.blackall.ai/api/v1/projects/abcdefghijklmnopqrst/buckets/value/empty', {
  method: 'POST',
  headers: { authorization: `Bearer ${process.env.ONEEND_TOKEN}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "confirm": "my-project"
  }),
})
const result = await response.json()

GET /api/v1/projects/{ref}/buckets/{bucket}/objects

ファイル一覧 バケット内の1つのフォルダーを表示します。サブフォルダーとファイルの名前、サイズ、形式です。prefixでフォルダーを選び（例: avatars/2024/）、searchで名前を探します。