Arsitektur Dokumentasi

Peta jalan panduan, SDK integration, dan API reference lengkap yang disiapkan secara terstruktur.

TULIS CMS/DEVELOPER HUB

/api-reference-workspace-members

Workspace Members

Mengelola anggota dalam workspace. Memerlukan Bearer Token (JWT) + Tenant Scoping (header X-Workspace-ID atau subdomain).

Semua endpoint di bawah menggunakan prefix /api/workspaces/:id.

Role & Permission

Role	Bobot	Deskripsi
`owner`	4	Pemilik workspace, akses penuh termasuk hapus workspace.
`admin`	4	Setara owner, bisa kelola anggota dan pengaturan.
`editor`	3	Kelola konten, publish, taxonomy, moderasi komentar.
`author`	2	Buat dan edit konten sendiri. Tidak bisa publish.
`subscriber`	1	Read-only. Hanya bisa melihat konten.

Add Member

Menambahkan pengguna ke workspace berdasarkan email.

Endpoint

POST /api/workspaces/:id/members

Request Body

Field	Type	Required	Description
`email`	string	ya	Email pengguna yang akan ditambahkan.
`role`	string	ya	Role (`owner`, `admin`, `editor`, `author`, `subscriber`).

{
  "email": "budi@example.com",
  "role": "author"
}

Response

{
  "status": 201,
  "message": "Member added successfully",
  "data": {
    "user_id": "d4e5f6a7-4444-5555-6666-777788889999",
    "name": "Budi Santoso",
    "email": "budi@example.com",
    "role": "author"
  }
}

List Members

Mendapatkan daftar semua anggota workspace.

Endpoint

GET /api/workspaces/:id/members

Response

{
  "status": 200,
  "message": "Members retrieved",
  "data": [
    {
      "user_id": "c3d4e5f6-3333-4444-5555-666677778888",
      "name": "Ahmad Fulan",
      "email": "ahmad@example.com",
      "role": "owner",
      "joined_at": "2026-01-15T08:00:00Z"
    },
    {
      "user_id": "d4e5f6a7-4444-5555-6666-777788889999",
      "name": "Budi Santoso",
      "email": "budi@example.com",
      "role": "author",
      "joined_at": "2026-01-16T09:00:00Z"
    }
  ]
}

Update Member Role

Mengubah role anggota workspace.

Endpoint

PUT /api/workspaces/:id/members/:userId

Request Body

Field	Type	Required	Description
`role`	string	ya	Role baru untuk anggota.

{
  "role": "editor"
}

Response

{
  "status": 200,
  "message": "Member role updated"
}

Remove Member

Mengeluarkan anggota dari workspace.

Endpoint

DELETE /api/workspaces/:id/members/:userId

Response

{
  "status": 200,
  "message": "Member removed successfully"
}

Lini Masa Peluncuran Fitur

Fase 1: Setup Awal & KonfigurasiSELESAI

Docker Compose, pengaturan file environment, dan panduan setup lokal telah lengkap dibuat.

Fase 2: Referensi RESTful APISELESAI

Dokumentasi route endpoint publik, otentikasi JWT, dan kontrol hak akses telah selesai disusun.

Fase 3: Integrasi Frontend & Fitur LanjutSEDANG BERJALAN

Mempersiapkan boilerplate untuk Next.js client, manajemen revisi konten, dan optimasi query.