Admin workspace
Pengaturan workspace, anggota, undangan, grup, proyek, dan publikasi.
Pengaturan workspace, anggota, undangan, grup, proyek, dan publikasi. Lihat Token dan izin untuk aturan akses.
| Tool | Jenis | Ringkasan |
|---|---|---|
workspace_settings | baca | Reads a workspace's settings: name, slug, timezone, company size, two-factor policy, owner and your role. |
update_workspace | tulis | Changes workspace settings. |
workspace_billing | baca | The workspace's plan (read-only): included features, seat/project/storage limits, current usage and the plans available. |
workspace_permissions | baca | What each workspace role (owner, admin, member, guest) may do, plus your own role and allowed actions. |
list_members | baca | Lists the people in a workspace with their role (owner, admin, member, guest) and the groups they are in. |
set_member_role | tulis | Changes a workspace member's role. |
remove_member | tulis | Removes a person from the workspace. |
transfer_workspace_ownership | tulis | Makes an existing admin or member the workspace owner. |
list_invites | baca | Lists pending email invites of a workspace (each with its personal join link) and the reusable invite links. |
invite_member | tulis | Invites someone by email to the workspace with a role. |
resend_invite | tulis | Sends a pending email invite again and restarts its 14-day validity. |
revoke_invite | tulis | Cancels a pending email invite; its link stops working. |
create_invite_link | tulis | Creates a reusable join link that adds whoever opens it with the given role. |
revoke_invite_link | tulis | Turns off a reusable join link. |
list_groups | baca | Lists member groups (teams, divisions...) of a workspace with their members. |
create_group | tulis | Creates a member group. |
update_group | tulis | Renames or edits a member group and adds/removes members. |
delete_group | tulis | Deletes a member group. |
create_project | tulis | Creates a project (you become its admin) with the default statuses Backlog, To do, In progress, Done, Dropped. |
get_project | baca | Reads a project's settings: key, visibility, lead, timezone, guest access and which features are switched on. |
update_project | tulis | Changes project settings. |
archive_project | tulis | Archives a project (read-only, hidden from lists, frees a project slot of the plan) or restores it with restore=true. |
delete_project | tulis | Permanently deletes a project with all its work items, comments, cycles, modules, pages and settings. |
move_project_to_workspace | tulis | Moves a project with everything in it (work items, comments, attachments, pages, whiteboards, cycles, modules, milestones, epics, releases, intake, views, automations, time entries, members) to another workspace you belong to. |
copy_project_setup | tulis | Copies setup from another project in the same workspace into this one: statuses and tags missing by name, members (existing roles kept), and feature switches. |
list_project_members | baca | Lists the members of a project with their project role (admin, member, viewer) and workspace role. |
set_project_member | tulis | Adds workspace members to a project, or changes their project role. |
remove_project_member | tulis | Takes people out of a project; they keep their workspace membership (and can still see open projects). |
get_project_publish | baca | Whether a project is published as a read-only public web page, its public link and what the page shows. |
set_project_publish | tulis | Publishes or unpublishes a project as a read-only public page anyone with the link can open, and chooses what it shows. regenerate_link makes the old link stop working. |
workspace_settings
Hanya baca. Bisa dipakai dengan token baca saja.
Reads a workspace's settings: name, slug, timezone, company size, two-factor policy, owner and your role.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
update_workspace
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes workspace settings. Changing the slug changes every URL of the workspace; use the new slug afterwards. Needs workspace admin or owner.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
name | string | tidak | minimal 1 karakter |
slug | string | tidak | pola ^[a-z0-9][a-z0-9-]{1,46}[a-z0-9]$ |
timezone | string | tidak | IANA name, e.g. Asia/Jakarta |
company_size | "1" / "2-10" / "11-50" / "51-200" / "201-500" / "501-1000" / "1000+" / null | tidak | null clears it |
logo_url | string / null | tidak | null removes the logo |
require_two_factor | boolean | tidak | Turning it on needs two-factor on your own account first |
workspace_billing
Hanya baca. Bisa dipakai dengan token baca saja.
The workspace's plan (read-only): included features, seat/project/storage limits, current usage and the plans available. Use it to explain 'blocked by the workspace plan' errors.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
workspace_permissions
Hanya baca. Bisa dipakai dengan token baca saja.
What each workspace role (owner, admin, member, guest) may do, plus your own role and allowed actions. With project, the project roles (admin, member, viewer) instead.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | tidak | Project key, id or name |
list_members
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the people in a workspace with their role (owner, admin, member, guest) and the groups they are in.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
role | "owner" / "admin" / "member" / "guest" | tidak | Only this role |
set_member_role
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a workspace member's role. Admins can change members and guests; only the owner can change admins. Turning a guest into a member uses a paid seat. Nobody can change their own role or the owner's.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
member | string | ya | Email, name or account id |
role | "admin" / "member" / "guest" | ya |
remove_member
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Removes a person from the workspace. They lose access to every project, are taken out of all projects and groups, and need a new invite to come back. Their work items, comments and pages stay. Needs confirm=true.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
member | string | ya | Email, name or account id |
confirm | boolean | tidak | Must be true; without it the tool only describes what would be lost |
transfer_workspace_ownership
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Makes an existing admin or member the workspace owner. The current owner (the caller) becomes an admin; the new owner is notified. Only the owner can do this. Needs confirm=true.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
member | string | ya | Email, name or account id of the new owner (an admin or member) |
confirm | boolean | tidak | Must be true; without it the tool only describes what would be lost |
list_invites
Hanya baca. Bisa dipakai dengan token baca saja.
Lists pending email invites of a workspace (each with its personal join link) and the reusable invite links. Needs workspace admin.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
invite_member
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Invites someone by email to the workspace with a role. They join after signing in with that address, or through the returned link (valid 14 days). Admin and member invites use a paid seat; guests do not. Inviting an admin needs the owner.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
email | string | ya | pola ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ |
role | "admin" / "member" / "guest" | ya |
resend_invite
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Sends a pending email invite again and restarts its 14-day validity.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
invite | string | ya | Invited email or invite id |
revoke_invite
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Cancels a pending email invite; its link stops working.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
invite | string | ya | Invited email or invite id |
create_invite_link
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a reusable join link that adds whoever opens it with the given role. Optional expiry and use limit. Admin links need the owner.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
role | "admin" / "member" / "guest" | ya | |
expires_in_days | integer | tidak | Default: never expires; 1–365 |
max_uses | integer | tidak | Default: unlimited; 1–10000 |
revoke_invite_link
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Turns off a reusable join link.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
link_id | string | ya | Id from list_invites; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
list_groups
Hanya baca. Bisa dipakai dengan token baca saja.
Lists member groups (teams, divisions...) of a workspace with their members.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
create_group
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a member group. Needs workspace admin.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
name | string | ya | minimal 1 karakter |
kind | string | tidak | Type label, e.g. "Team" or "Division" (default "Group") |
description | string | tidak | |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
members | array<string> | tidak | Emails or names |
update_group
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Renames or edits a member group and adds/removes members. Needs workspace admin.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
group | string | ya | Group name or id |
name | string | tidak | minimal 1 karakter |
kind | string | tidak | |
description | string | tidak | |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
add_members | array<string> | tidak | Emails or names to add |
remove_members | array<string> | tidak | Emails or names to take out |
delete_group
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a member group. People stay in the workspace and keep their project memberships. Needs workspace admin.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
group | string | ya | Group name or id |
create_project
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a project (you become its admin) with the default statuses Backlog, To do, In progress, Done, Dropped. The plan may limit how many active projects a workspace has.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
name | string | ya | minimal 1 karakter |
key | string | ya | Short code used in references like KEY-12; pola ^[A-Za-z][A-Za-z0-9]{1,9}$ |
description | string | tidak | |
icon | string | tidak | An emoji |
visibility | "open" / "restricted" | tidak | open (default): every workspace member can see it; restricted: only project members |
lead | string | tidak | Email or name of the project lead; "me" for yourself |
cover_url | string | tidak |
get_project
Hanya baca. Bisa dipakai dengan token baca saja.
Reads a project's settings: key, visibility, lead, timezone, guest access and which features are switched on. Also finds archived projects.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
update_project
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes project settings. Changing the key changes the references of its work items (KEY-12). Needs project admin.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
name | string | tidak | minimal 1 karakter |
key | string | tidak | pola ^[A-Za-z][A-Za-z0-9]{1,9}$ |
description | string | tidak | |
icon | string / null | tidak | Emoji; null removes it |
visibility | "open" / "restricted" | tidak | |
lead | string / null | tidak | Email or name; "me"; null clears the lead |
cover_url | string / null | tidak | |
timezone | string | tidak | IANA name |
allow_guests | boolean | tidak | false also removes guests from the project |
guests_see_all | boolean | tidak | Guests see every work item, not only their own |
features | object | tidak | Switch features on/off, e.g. {"cycles": false}. Keys: cycles, epics, milestones, modules, views, pages, whiteboards, intake, releases |
archive_project
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Archives a project (read-only, hidden from lists, frees a project slot of the plan) or restores it with restore=true.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
restore | boolean | tidak |
delete_project
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Permanently deletes a project with all its work items, comments, cycles, modules, pages and settings. Cannot be undone; prefer archive_project. Needs confirm=true.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
confirm | boolean | tidak | Must be true; without it the tool only describes what would be lost |
move_project_to_workspace
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Moves a project with everything in it (work items, comments, attachments, pages, whiteboards, cycles, modules, milestones, epics, releases, intake, views, automations, time entries, members) to another workspace you belong to. Without confirm=true it only previews: counts of what moves, people outside the target workspace (each must be invited or dropped), labels matched by name or copied, links that get cut (goals, initiatives, teamspaces, workspace views, cross-project relations and parent links, Slack channels, customer requests) and whether the key clashes. Old references and links redirect. Dropped people are removed from the project, its assignees, module/whiteboard members and pending approvals. Needs workspace admin on both sides.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
target_workspace | string | ya | Slug or name of the workspace to move into |
new_key | string | tidak | Needed when the key is taken in the target; pola ^[A-Za-z][A-Za-z0-9]{1,9}$ |
invite | array<string> | tidak | People (email, name or id) from the preview to invite into the target workspace |
drop | array<string> | tidak | People from the preview to drop from the project |
others | "invite" / "drop" | tidak | What to do with preview people not listed in invite/drop |
confirm | boolean | tidak | Must be true; without it the tool only describes what would be lost |
copy_project_setup
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Copies setup from another project in the same workspace into this one: statuses and tags missing by name, members (existing roles kept), and feature switches.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Target project key, id or name |
from | string | ya | Source project key, id or name |
statuses | boolean | tidak | |
tags | boolean | tidak | |
members | boolean | tidak | |
features | boolean | tidak |
list_project_members
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the members of a project with their project role (admin, member, viewer) and workspace role.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
set_project_member
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds workspace members to a project, or changes their project role. Guests can only be viewers, and only when the project allows guests. Pass group to add a whole member group (people already in keep their role).
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
members | array<string> | tidak | Emails or names |
group | string | tidak | Member group name or id |
role | "admin" / "member" / "viewer" | ya |
remove_project_member
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Takes people out of a project; they keep their workspace membership (and can still see open projects).
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
members | array<string> | ya | Emails or names |
get_project_publish
Hanya baca. Bisa dipakai dengan token baca saja.
Whether a project is published as a read-only public web page, its public link and what the page shows.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
set_project_publish
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Publishes or unpublishes a project as a read-only public page anyone with the link can open, and chooses what it shows. regenerate_link makes the old link stop working.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
project | string | ya | Project key, id or name |
enabled | boolean | tidak | |
regenerate_link | boolean | tidak | |
show | object { list, board, defaultView, priority, assignees, dueDates, labels, description, completed } | tidak | Page options; unspecified ones keep their value |