Work item lanjutan
Arsip, hapus, pindah, relasi, tautan, riwayat, time tracking, custom field, approval, dan recurrence.
Arsip, hapus, pindah, relasi, tautan, riwayat, time tracking, custom field, approval, dan recurrence. Lihat Token dan izin untuk aturan akses.
| Tool | Jenis | Ringkasan |
|---|---|---|
archive_work_item | tulis | Archives a work item (hides it from normal lists), or restores it with restore=true. |
delete_work_item | tulis | Permanently deletes a work item and everything on it. |
move_work_item | tulis | Moves a work item (and by default its sub-items) to another project of the same workspace; it gets a new reference. |
set_work_item_subscription | tulis | Subscribes you to (or unsubscribes you from) notifications about a work item. |
list_work_item_relations | baca | Lists how a work item relates to others: blocks, blocked_by, relates, duplicate_of, duplicated_by. |
add_work_item_relation | tulis | Relates two work items of the same workspace, e.g. |
remove_work_item_relation | tulis | Removes the relation between two work items. |
list_work_item_links | baca | Lists the external links (URL and title) on a work item, and its file attachments. |
add_work_item_link | tulis | Adds an external http(s) link to a work item. |
remove_work_item_link | tulis | Removes a link from a work item (linkId from list_work_item_links). |
edit_comment | tulis | Replaces the text of a comment (comment ids come from get_work_item with include_comments). |
delete_comment | tulis | Deletes a comment. |
list_work_item_activity | baca | The change log of a work item: who changed which field from what to what, and when. |
list_work_item_versions | baca | Title and description history of a work item, newest first. |
restore_work_item_version | tulis | Puts an earlier title and description (version_id from list_work_item_versions) back on its work item. |
log_time | tulis | Logs time spent on a work item. |
list_time_entries | baca | Time logged on a work item, with the total. |
delete_time_entry | tulis | Deletes a time entry (entryId from list_time_entries). |
start_timer | tulis | Starts your timer on a work item. |
stop_timer | tulis | Stops your running timer in a workspace and logs the time; action=discard throws it away, action=show only shows it. |
list_work_item_types | baca | Lists the work item types (Task, Bug, Story, ...) of a project. |
list_custom_fields | baca | Lists a project's custom fields, their kind, options and which types they apply to. |
update_work_item_fields | tulis | Sets the type and/or custom field values of a work item. |
list_approvals | baca | Approval requests. |
request_approval | tulis | Asks one or more people to approve a work item; all must approve, one rejection rejects. |
decide_approval | tulis | Approves or rejects an approval request you were asked to decide, or cancels one you requested (decision=cancel). |
get_recurrence | baca | Shows whether a work item repeats, its rule, next date and the items the series created so far. |
set_recurrence | tulis | Makes a work item repeat (a copy is created on each date), changes the rule, or stops it with stop=true. |
archive_work_item
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Archives a work item (hides it from normal lists), or restores it with restore=true. 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 |
restore | boolean | tidak | Unarchive instead |
delete_work_item
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Permanently deletes a work item and everything on it. Cannot be undone; prefer archive_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 |
move_work_item
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Moves a work item (and by default its sub-items) to another project of the same workspace; it gets a new reference. Use dry_run to see what would change or be dropped. 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 |
to_project | string | tidak | Target project key, id or name; omit to list the projects it can move to |
sub_items | boolean | tidak | Move sub-items too (default true) |
dry_run | boolean | tidak | Only preview the move |
set_work_item_subscription
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Subscribes you to (or unsubscribes you from) notifications about a work item. Omit subscribed to just read the current state.
| 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 |
subscribed | boolean | tidak |
list_work_item_relations
Hanya baca. Bisa dipakai dengan token baca saja.
Lists how a work item relates to others: blocks, blocked_by, relates, duplicate_of, duplicated_by.
| 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 |
add_work_item_relation
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Relates two work items of the same workspace, e.g. PROJ-1 blocks PROJ-2. Two items can have only one relation. 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 | The item the relation is read from, e.g. the blocker for kind=blocks |
kind | "blocks" / "blocked_by" / "relates" / "duplicate_of" / "duplicated_by" | ya | |
other | string | ya | The other work item's reference or id |
remove_work_item_relation
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Removes the relation between two work items. 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 |
other | string | ya | The other work item's reference or id |
list_work_item_links
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the external links (URL and title) on a work item, and its file attachments.
| 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 |
add_work_item_link
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds an external http(s) link 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 |
url | string | ya | minimal 1 karakter |
title | string | tidak |
remove_work_item_link
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Removes a link from a work item (linkId from list_work_item_links). Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
link_id | string | ya | linkId from list_work_item_links |
edit_comment
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Replaces the text of a comment (comment ids come from get_work_item with include_comments). Usually only your own. Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
comment_id | string | ya | |
text | string | ya | Plain text; minimal 1 karakter |
delete_comment
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a comment. Usually only your own. Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
comment_id | string | ya |
list_work_item_activity
Hanya baca. Bisa dipakai dengan token baca saja.
The change log of a work item: who changed which field from what to what, and when.
| 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 |
list_work_item_versions
Hanya baca. Bisa dipakai dengan token baca saja.
Title and description history of a work item, newest first. Pass version_id (item not needed then) to read that version's full text.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
item | string | tidak | Reference like PROJ-12, or the id |
version_id | string | tidak |
restore_work_item_version
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Puts an earlier title and description (version_id from list_work_item_versions) back on its 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) |
version_id | string | ya |
log_time
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Logs time spent on a work item. Give minutes and/or hours. Needs write access and time tracking turned on for the project.
| 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 |
minutes | integer | tidak | 0–9007199254740991 |
hours | number | tidak | min 0 |
spent_on | string | tidak | Default today; format YYYY-MM-DD |
note | string | tidak | |
person | string | tidak | Log for someone else (project admins only); email or name |
list_time_entries
Hanya baca. Bisa dipakai dengan token baca saja.
Time logged on a work item, with the total.
| 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 |
delete_time_entry
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a time entry (entryId from list_time_entries). Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
entry_id | string | ya |
start_timer
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Starts your timer on a work item. A timer already running in the workspace is stopped first and logged. 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 |
note | string | tidak |
stop_timer
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Stops your running timer in a workspace and logs the time; action=discard throws it away, action=show only shows it.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
action | "stop" / "show" / "discard" | tidak | Default stop |
note | string | tidak | Note for the logged entry |
list_work_item_types
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the work item types (Task, Bug, Story, ...) 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_custom_fields
Hanya baca. Bisa dipakai dengan token baca saja.
Lists a project's custom fields, their kind, options and which types they apply to. Pass item to also see that item's values.
| 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 (or give item) |
item | string | tidak | Reference like PROJ-12, or the id |
update_work_item_fields
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Sets the type and/or custom field values of a work item. Fields are given by name; select values by option label, member values by email or name, dates as YYYY-MM-DD; null clears a value. 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 |
type | string / null | tidak | Work item type name or id; null removes the type |
fields | object | tidak | Field name -> value, e.g. {"Severity": "High", "Story points": 3, "Platforms": ["iOS", "Web"]} |
list_approvals
Hanya baca. Bisa dipakai dengan token baca saja.
Approval requests. With item: the requests on that work item. Without: requests across the workspace waiting for your decision (scope=waiting), made by you (requested) or all.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
item | string | tidak | Reference like PROJ-12, or the id |
scope | "waiting" / "requested" / "all" | tidak | Without item; default waiting |
request_approval
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Asks one or more people to approve a work item; all must approve, one rejection rejects. 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 |
approvers | array<string> | ya | Emails or names (not yourself) |
note | string | tidak |
decide_approval
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Approves or rejects an approval request you were asked to decide, or cancels one you requested (decision=cancel). Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
approval_id | string | ya | approvalId from list_approvals |
decision | "approved" / "rejected" / "cancel" | ya | |
comment | string | tidak |
get_recurrence
Hanya baca. Bisa dipakai dengan token baca saja.
Shows whether a work item repeats, its rule, next date and the items the series created so far.
| 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 |
set_recurrence
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Makes a work item repeat (a copy is created on each date), changes the rule, or stops it with stop=true. 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 |
stop | boolean | tidak | Stop repeating; the other fields are ignored |
frequency | "daily" / "weekly" / "monthly" / "interval" | tidak | |
every_days | integer | tidak | For interval; 1–365 |
weekdays | array<"mon" / "tue" / "wed" / "thu" / "fri" / "sat" / "sun"> | tidak | For weekly |
month_day | integer | tidak | For monthly; 31 = last day; 1–31 |
starts_on | string | tidak | First date a copy may be created; default tomorrow; format YYYY-MM-DD |
ends_on | string | tidak | format YYYY-MM-DD |
count | integer | tidak | Total occurrences including this item; 1–1000 |