Perbarui nama proyek yang ada di Blue
Ganti Nama Proyek
Memperbarui nama dan properti lain dari proyek yang ada. Ketika nama diubah, slug proyek akan secara otomatis dihasilkan ulang berdasarkan nama baru.
Contoh Dasar
mutation RenameProject {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
}) {
id
name
slug
}
}
Contoh Lanjutan
mutation EditProjectAdvanced {
editProject(input: {
projectId: "project_abc123"
name: "Q2 Marketing Campaign"
description: "Campaign for Q2 product launch"
color: "#3B82F6"
icon: "campaign"
category: MARKETING
todoAlias: "Task"
hideRecordCount: false
}) {
id
name
slug
description
color
icon
category
todoAlias
hideRecordCount
}
}
Parameter |
Tipe |
Diperlukan |
Deskripsi |
projectId |
String! |
✅ Ya |
ID proyek yang akan diedit |
name |
String |
Tidak |
Nama baru untuk proyek |
slug |
String |
Tidak |
Slug yang ramah URL (dihasilkan otomatis jika tidak diberikan) |
description |
String |
Tidak |
Deskripsi proyek |
color |
String |
Tidak |
Kode warna hex untuk proyek (misalnya, #3B82F6) |
icon |
String |
Tidak |
Identifikasi ikon untuk proyek |
category |
ProjectCategory |
Tidak |
Kategori proyek |
todoAlias |
String |
Tidak |
Nama kustom untuk catatan dalam proyek ini |
hideRecordCount |
Boolean |
Tidak |
Apakah menyembunyikan jumlah catatan di UI |
showTimeSpentInTodoList |
Boolean |
Tidak |
Tampilkan pelacakan waktu dalam daftar |
showTimeSpentInProject |
Boolean |
Tidak |
Tampilkan pelacakan waktu dalam tampilan proyek |
image |
ImageInput |
Tidak |
Gambar/cover proyek |
todoFields |
[TodoFieldInput] |
Tidak |
Konfigurasi field kustom |
coverConfig |
TodoCoverConfigInput |
Tidak |
Konfigurasi tampilan cover |
features |
[ProjectFeatureInput] |
Tidak |
Pengaturan fitur untuk proyek |
sequenceCustomFieldId |
String |
Tidak |
Field kustom yang digunakan untuk urutan catatan |
Nilai ProjectCategory
Nilai |
Deskripsi |
PERSONAL |
Proyek pribadi |
BUSINESS |
Proyek bisnis |
MARKETING |
Kampanye pemasaran |
DEVELOPMENT |
Proyek pengembangan |
DESIGN |
Proyek desain |
OPERATIONS |
Tugas operasional |
SALES |
Kegiatan penjualan |
SUPPORT |
Tiket dukungan |
FINANCE |
Pelacakan keuangan |
HR |
Sumber daya manusia |
LEGAL |
Masalah hukum |
PROCUREMENT |
Proses pengadaan |
Field Respon
Mengembalikan objek Proyek yang diperbarui dengan semua field. Field kunci termasuk:
Field |
Tipe |
Deskripsi |
id |
String! |
ID Proyek |
name |
String! |
Nama Proyek |
slug |
String! |
Slug yang ramah URL |
description |
String |
Deskripsi Proyek |
color |
String |
Kode warna hex |
icon |
String |
Identifikasi ikon |
category |
ProjectCategory |
Kategori Proyek |
todoAlias |
String |
Nama catatan kustom |
hideRecordCount |
Boolean! |
Pengaturan visibilitas jumlah catatan |
createdAt |
DateTime! |
Timestamp pembuatan |
updatedAt |
DateTime! |
Timestamp pembaruan terakhir |
Izin yang Diperlukan
Peran |
Dapat Mengedit Proyek |
OWNER |
✅ Ya |
ADMIN |
✅ Ya |
MEMBER |
❌ Tidak |
Respon Kesalahan
Proyek Tidak Ditemukan
{
"errors": [{
"message": "Project was not found.",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Izin Tidak Cukup
{
"errors": [{
"message": "You don't have permission to edit this project",
"extensions": {
"code": "FORBIDDEN"
}
}]
}
Catatan Penting
- Generasi Slug: Slug proyek dihasilkan secara otomatis ketika nama diubah. Anda juga dapat memberikan slug kustom.
- Konflik Slug: Jika slug bertentangan dengan slug perusahaan yang ada, sistem akan menambahkan angka (misalnya,
my-project-1
).
- Sanitasi HTML: Tag HTML secara otomatis dihapus dari field deskripsi demi keamanan.
- Pembaruan Parsial: Semua field bersifat opsional kecuali
projectId
- hanya berikan field yang ingin Anda perbarui.
- Kategori: Gunakan nilai enum ProjectCategory untuk field kategori.
- Penanganan Gambar: Mendukung pengunggahan, pembaruan, atau penghapusan gambar proyek melalui ImageInput.
Operasi Terkait