MMyPlanDokumentasi
MCPReferensi tool

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.

ToolJenisRingkasan
archive_work_itemtulisArchives a work item (hides it from normal lists), or restores it with restore=true.
delete_work_itemtulisPermanently deletes a work item and everything on it.
move_work_itemtulisMoves a work item (and by default its sub-items) to another project of the same workspace; it gets a new reference.
set_work_item_subscriptiontulisSubscribes you to (or unsubscribes you from) notifications about a work item.
list_work_item_relationsbacaLists how a work item relates to others: blocks, blocked_by, relates, duplicate_of, duplicated_by.
add_work_item_relationtulisRelates two work items of the same workspace, e.g.
remove_work_item_relationtulisRemoves the relation between two work items.
list_work_item_linksbacaLists the external links (URL and title) on a work item, and its file attachments.
add_work_item_linktulisAdds an external http(s) link to a work item.
remove_work_item_linktulisRemoves a link from a work item (linkId from list_work_item_links).
edit_commenttulisReplaces the text of a comment (comment ids come from get_work_item with include_comments).
delete_commenttulisDeletes a comment.
list_work_item_activitybacaThe change log of a work item: who changed which field from what to what, and when.
list_work_item_versionsbacaTitle and description history of a work item, newest first.
restore_work_item_versiontulisPuts an earlier title and description (version_id from list_work_item_versions) back on its work item.
log_timetulisLogs time spent on a work item.
list_time_entriesbacaTime logged on a work item, with the total.
delete_time_entrytulisDeletes a time entry (entryId from list_time_entries).
start_timertulisStarts your timer on a work item.
stop_timertulisStops your running timer in a workspace and logs the time; action=discard throws it away, action=show only shows it.
list_work_item_typesbacaLists the work item types (Task, Bug, Story, ...) of a project.
list_custom_fieldsbacaLists a project's custom fields, their kind, options and which types they apply to.
update_work_item_fieldstulisSets the type and/or custom field values of a work item.
list_approvalsbacaApproval requests.
request_approvaltulisAsks one or more people to approve a work item; all must approve, one rejection rejects.
decide_approvaltulisApproves or rejects an approval request you were asked to decide, or cancels one you requested (decision=cancel).
get_recurrencebacaShows whether a work item repeats, its rule, next date and the items the series created so far.
set_recurrencetulisMakes 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
restorebooleantidakUnarchive 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
to_projectstringtidakTarget project key, id or name; omit to list the projects it can move to
sub_itemsbooleantidakMove sub-items too (default true)
dry_runbooleantidakOnly 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
subscribedbooleantidak

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaThe item the relation is read from, e.g. the blocker for kind=blocks
kind"blocks" / "blocked_by" / "relates" / "duplicate_of" / "duplicated_by"ya
otherstringyaThe 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
otherstringyaThe other work item's reference or id

Hanya baca. Bisa dipakai dengan token baca saja.

Lists the external links (URL and title) on a work item, and its file attachments.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id

Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.

Adds an external http(s) link to a work item. Needs write access.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
urlstringyaminimal 1 karakter
titlestringtidak

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.

ParameterTipeWajibKeterangan
link_idstringyalinkId 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.

ParameterTipeWajibKeterangan
comment_idstringya
textstringyaPlain 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.

ParameterTipeWajibKeterangan
comment_idstringya

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringtidakReference like PROJ-12, or the id
version_idstringtidak

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
version_idstringya

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
minutesintegertidak0–9007199254740991
hoursnumbertidakmin 0
spent_onstringtidakDefault today; format YYYY-MM-DD
notestringtidak
personstringtidakLog 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference 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.

ParameterTipeWajibKeterangan
entry_idstringya

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
notestringtidak

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
action"stop" / "show" / "discard"tidakDefault stop
notestringtidakNote 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringyaProject 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
projectstringtidakProject key, id or name (or give item)
itemstringtidakReference 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
typestring / nulltidakWork item type name or id; null removes the type
fieldsobjecttidakField 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringtidakReference like PROJ-12, or the id
scope"waiting" / "requested" / "all"tidakWithout 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
approversarray<string>yaEmails or names (not yourself)
notestringtidak

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.

ParameterTipeWajibKeterangan
approval_idstringyaapprovalId from list_approvals
decision"approved" / "rejected" / "cancel"ya
commentstringtidak

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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference 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.

ParameterTipeWajibKeterangan
workspacestringtidakWorkspace slug or name; needed when the token reaches more than one (see list_workspaces)
itemstringyaReference like PROJ-12, or the id
stopbooleantidakStop repeating; the other fields are ignored
frequency"daily" / "weekly" / "monthly" / "interval"tidak
every_daysintegertidakFor interval; 1–365
weekdaysarray<"mon" / "tue" / "wed" / "thu" / "fri" / "sat" / "sun">tidakFor weekly
month_dayintegertidakFor monthly; 31 = last day; 1–31
starts_onstringtidakFirst date a copy may be created; default tomorrow; format YYYY-MM-DD
ends_onstringtidakformat YYYY-MM-DD
countintegertidakTotal occurrences including this item; 1–1000

Di halaman ini