Inti
Workspace, proyek, pencarian dan pembuatan work item, komentar, cycle dan module.
Workspace, proyek, pencarian dan pembuatan work item, komentar, cycle dan module. Lihat Token dan izin untuk aturan akses.
| Tool | Jenis | Ringkasan |
|---|---|---|
whoami | baca | Shows who the token acts as, whether it reaches the whole account or one workspace, and its scopes (read or read+write). |
list_workspaces | baca | Lists the workspaces this token can reach (slug and name). |
list_projects | baca | Lists the projects in a workspace with their key (used in references like KEY-12) and task counts. |
project_details | baca | Statuses of a project plus the workspace members and tags, i.e. the values work items can use. |
list_work_items | baca | Searches the work items of one project. |
my_work_items | baca | Work items assigned to you (or created by you). |
get_work_item | baca | Reads one work item with its description and, optionally, its comments. |
create_work_item | tulis | Creates a work item in a project. |
update_work_item | tulis | Changes a work item. |
add_comment | tulis | Adds a comment to a work item. |
list_cycles | baca | Lists the cycles (sprints) of a project. |
list_modules | baca | Lists the modules of a project. |
whoami
Hanya baca. Bisa dipakai dengan token baca saja.
Shows who the token acts as, whether it reaches the whole account or one workspace, and its scopes (read or read+write).
Tanpa parameter.
list_workspaces
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the workspaces this token can reach (slug and name). Pass the slug as workspace to the other tools.
Tanpa parameter.
list_projects
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the projects in a workspace with their key (used in references like KEY-12) and task counts.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
include_archived | boolean | tidak | Also list archived projects |
project_details
Hanya baca. Bisa dipakai dengan token baca saja.
Statuses of a project plus the workspace members and tags, i.e. the values work items can use.
| 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 |
list_work_items
Hanya baca. Bisa dipakai dengan token baca saja.
Searches the work items of one project. Filters combine with AND; values inside one filter combine with OR.
| 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 |
search | string | tidak | Text in the title or reference |
status | array<string> | tidak | Status names |
category | array<"backlog" / "todo" / "active" / "done" / "dropped"> | tidak | Status categories |
priority | array<"none" / "low" / "medium" / "high" / "urgent"> | tidak | |
assignee | array<string> | tidak | Emails or names; "me" for yourself, "none" for unassigned |
tag | array<string> | tidak | Tag names |
due_before | string | tidak | format YYYY-MM-DD |
due_after | string | tidak | format YYYY-MM-DD |
top_level | boolean | tidak | Only items without a parent |
archived | boolean | tidak | List archived items instead |
limit | integer | tidak | Default 25; 1–100 |
cursor | integer | tidak | nextCursor from the previous page; -9007199254740991–9007199254740991 |
my_work_items
Hanya baca. Bisa dipakai dengan token baca saja.
Work items assigned to you (or created by you). Without workspace it covers every workspace the token reaches.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
scope | "assigned" / "created" | tidak | Default assigned |
include_closed | boolean | tidak | Also include done and dropped items |
get_work_item
Hanya baca. Bisa dipakai dengan token baca saja.
Reads one work item with its description and, optionally, its comments.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
item | string | ya | Reference like PROJ-12, or the id |
include_comments | boolean | tidak |
create_work_item
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a work item in a project. Needs write access.
| 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 |
title | string | ya | minimal 1 karakter |
description | string | tidak | Plain text; blank lines start new paragraphs |
status | string | tidak | Status name, or a category (backlog, todo, active, done, dropped) |
priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | |
assignees | array<string> | tidak | Emails or names; "me" for yourself |
tags | array<string> | tidak | Tag names |
start_on | string | tidak | format YYYY-MM-DD |
due_on | string | tidak | format YYYY-MM-DD |
estimate | number | tidak | |
parent | string | tidak | Parent work item reference or id |
update_work_item
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a work item. Only the fields given change; pass clear to empty dates, estimate or parent. Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
item | string | ya | Reference like PROJ-12, or the id |
title | string | tidak | minimal 1 karakter |
description | string | tidak | Plain text; blank lines start new paragraphs |
status | string | tidak | Status name, or a category (backlog, todo, active, done, dropped) |
priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | |
assignees | array<string> | tidak | Emails or names; "me" for yourself |
tags | array<string> | tidak | Tag names |
start_on | string | tidak | format YYYY-MM-DD |
due_on | string | tidak | format YYYY-MM-DD |
estimate | number | tidak | |
parent | string | tidak | Parent work item reference or id |
clear | array<"start_on" / "due_on" / "estimate" / "parent"> | tidak |
add_comment
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds a comment to a work item. Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
item | string | ya | Reference like PROJ-12, or the id |
text | string | ya | Plain text; minimal 1 karakter |
list_cycles
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the cycles (sprints) of a project.
| 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 |
list_modules
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the modules of a project.
| 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 |