관리 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인 곳만 지금 만들 수 있어요. 리전은 나중에 못 바꾸니 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

서버 크기와 가격 서버 크기(메모리)마다 구글 서버, 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(초)를 주거나 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}

프로젝트 하나 list_projects가 돌려주는 항목 하나를 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}

이름 바꾸기 프로젝트 이름이나 조직 이름, 또는 둘 다 바꿔요. ID(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일 넘게 멈추면 데이터베이스를 보관 저장소로 옮겨요. 소유자·관리자만 돼요.

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 키 가져오기 프로젝트 주소와 두 키예요. 비밀 키는 접근 규칙을 무시하니 서버에서만 쓰세요(쓰기 권한 토큰 필요). 프론트엔드용이면 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 키 만들기 이름 붙은 키를 하나 만들어요. 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 키 폐기 이름 붙은 키 하나를 폐기해요. 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(기본)이면 지금 앱이 30초 안에 모두 멈추니 confirm에 프로젝트 이름이 필요해요. 사용자가 요청할 때만, 소유자·관리자만 돼요.

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로 돌려줘요(첫 줄은 열 이름). 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를 표에 넣어요. 첫 줄의 열 이름대로 들어가요(columns로 바꿔요). 한 줄이라도 실패하면 아무것도 넣지 않고 줄 번호와 이유를 알려 줘요. 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

표 목록 프로젝트의 표와 각 표의 칸, 대략의 줄 수, 접근 규칙 상태를 돌려줘요. 규칙이 켜져 있고 규칙 수가 0이면 공개 키로는 아무것도 보이지 않아요.

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

마이그레이션 적용 적용하지 않은 마이그레이션을 버전 순으로 하나씩 트랜잭션으로 실행하고 기록해요(적용된 건 건너뛰어요). 실패하면 그것만 되돌리고 멈추며 앞의 것은 남아요. run_sql 대신 쓰면 같은 변경을 다른 프로젝트에도 적용할 수 있어요. supabase/migrations 파일도 그대로 돼요: Supabase 이름(public., auth.uid(), storage., to authenticated)은 이 프로젝트 이름으로 바꿔 실행하고 translated로 알려 줘요.

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}

마이그레이션 기록 지우기 마이그레이션 하나를 적용하지 않은 것으로 되돌려요. 기록만 지우고 그 마이그레이션이 만든 것은 그대로 둬요.

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 조회 (읽기 전용) 조회 한 문장(SELECT 등)을 읽기 전용으로 실행해요(읽기 권한 토큰도 돼요). 바꾸는 문장은 run_sql을 쓰세요. Vault 비밀 값은 비어 있어요. 문법: 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 실행 (변경) 데이터나 구조를 바꾸는 SQL(CREATE, INSERT, UPDATE, DELETE 등)을 실행해요. 조회만이면 query_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로 알려 줘요.

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, 세션: 마이그레이션 도구·DB 클라이언트)와 pooler(6543, 트랜잭션: 서버리스). 비밀번호는 저장하지 않아 [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)이 필요해요. 이 사용자는 RLS를 거치지 않으니 서버에만 두세요. 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을 주면 그 앱만, 없으면 프로젝트의 앱 모두가 받아요. 서버는 시작할 때 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이면 프로젝트 전체용이 돼요. 앱 하나에는 데이터베이스 하나만 연결돼요. 실행 중인 서버는 다시 시작하거나 다시 배포하면 바뀐 값을 받아요.

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

DB 확장 목록 켤 수 있는 PostgreSQL 확장(vector, postgis, citext 등)과 available·enabled·버전이에요. extensions 스키마에 설치되고 SQL에서 vector(1536)처럼 바로 써요.

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}

DB 확장 켜기 확장 하나를 켜요(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}

DB 확장 끄기 확장을 꺼요. 쓰는 열·인덱스·함수가 남아 있으면 거절돼요. 다른 프로젝트가 쓰면 설치는 남고 이 프로젝트 기록만 지워요(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

전용 데이터베이스로 옮기기 프로젝트를 전용 데이터베이스로 옮기도록 요청해요(콘솔 "지금 옮기기"). 옮기는 동안 쓰기는 멈추고 읽기는 돼요. 직전 상태를 백업하고, 실패하면 그대로예요. 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))로 옮기도록 요청해요. GB당 월 ₩1,200(75¢)이고, 옮기는 동안 쓰기는 실패해요. 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% 아래로 쓴 디스크만 돼요(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}

표의 실시간 켜기·끄기 표 하나의 변경 알림을 켜거나 꺼요. 알림도 접근 규칙을 통과한 줄만 가요.

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을 올려 다시 부르세요.

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}

서비스 가입자 바꾸기 가입자 한 명의 이메일, 비밀번호, 이메일 확인, 정지, 메타데이터(합쳐짐)를 바꿔요. 비밀번호를 바꾸거나 정지하면 로그인이 모두 끊겨요. 비밀번호는 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

서비스 가입자 추가 이 프로젝트의 서비스에 가입자를 하나 만들어요. 비밀번호는 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}

소셜 로그인 켜기 제공자 하나의 클라이언트 ID와 시크릿을 저장하고 켜요(시크릿은 암호화해 저장하고 뒤 네 자리만 보여요). 먼저 제공자 콘솔에 list_auth_providers의 callback_url을 등록하세요. ID만 고치려면 client_secret을 빈 문자열로 둬요. provider를 custom:<이름>으로 주면 목록에 없는 OAuth 2.0·OpenID Connect 제공자를 등록해요: issuer(OIDC) 또는 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

돌아갈 주소 추가 주소 하나를 허용 목록에 넣어요. 스킴·호스트·포트가 모두 같아야 하고 경로는 보지 않아서 https://app.example.com/callback을 넣으면 https://app.example.com이 저장돼요. 모바일 앱은 자기 스킴(co.example.app://callback)을 넣으면 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

돌아갈 주소 제거 허용 목록에서 주소 하나를 빼요. 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

문자 로그인 설정 보기 전화번호 인증번호 로그인에 쓰는 문자 계정을 봐요: 제공자, 발신 번호, 허용 국가, 인증번호 길이·유효 시간, 시간당 한도. 자격증명은 뒤 네 자리만 보여요. platform_available이면 플랫폼 계정(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

문자 로그인 설정 문자 계정을 저장하고 켜요. 직접 계약한 제공자면 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·Textlocal: key, Vonage: key·secret. MessageBird·Textlocal·Vonage는 11자 이하 발신자 ID, Twilio Verify는 VA로 시작하는 Verify Service SID도 돼요). 나머지 설정은 update_auth_config의 SMS_* 키로 바꿔요. 비운 자격증명은 그대로예요. allowed_countries는 기본 82(한국)만이고, 모르는 나라를 넣으면 해외 유료 번호 문자 사기에 노출돼요.

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

문자 로그인 지우기 문자 계정 설정을 자격증명째로 지워요. 이후 전화번호 로그인은 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 서버와 보내는 사람을 봐요. 비밀번호는 password_hint(뒤 네 자리)만 와요. configured가 false거나 last_error가 있으면(그 서버가 거부) 플랫폼 주소로 보내요.

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 서버로 시험 메일 한 통을 보내요. 플랫폼으로 대신 보내지 않아서, 실패하면 그 서버가 준 이유가 그대로 나와요. 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

이메일 템플릿 보기 인증 메일 여섯 종류(confirmation, invite, magic_link, recovery, email_change, reauthentication)의 제목과 HTML 본문이에요. custom이 false면 기본 문구(한국어·영어·일본어)를 써요. type을 주면 그 하나만 봐요. 변수는 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}

이메일 템플릿 보기 인증 메일 여섯 종류(confirmation, invite, magic_link, recovery, email_change, reauthentication)의 제목과 HTML 본문이에요. custom이 false면 기본 문구(한국어·영어·일본어)를 써요. type을 주면 그 하나만 봐요. 변수는 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}

이메일 템플릿 저장 한 종류의 제목과 HTML 본문을 정해요(Supabase 템플릿 그대로 돼요). 제목은 한 줄, {{ if }} 같은 문법은 거부돼요. reauthentication은 아직 보내지 않아요. 저장 전에 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}

이메일 템플릿 되돌리기 한 종류의 템플릿을 지우고 기본 문구(한국어·영어·일본어)로 돌아가요.

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에 넣어야 하는 두 주소(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 하나를 지워요. 그 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}

가입자 삭제 프로젝트의 가입자 한 명을 지워요. 되돌릴 수 없어요. 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

파일 목록 버킷 안의 한 폴더를 봐요: 하위 폴더와 파일의 이름, 크기, 형식. prefix로 폴더를 고르고(예: avatars/2024/), search로 이름을 찾아요.