Goals & kolaborasi
Goals dan key result, initiative, project update, notifikasi, intake, dan customer.
Goals dan key result, initiative, project update, notifikasi, intake, dan customer. Lihat Token dan izin untuk aturan akses.
| Tool | Jenis | Ringkasan |
|---|---|---|
list_goals | baca | Lists the goals (objectives) of a workspace with status, progress, owner and period. |
get_goal | baca | Reads one goal with its key results, links, sub-goals and optionally the check-in history. |
create_goal | tulis | Creates a goal (objective) for a period. |
update_goal | tulis | Changes a goal. |
delete_goal | tulis | Deletes a goal with its key results, check-ins and links. |
add_key_result | tulis | Adds a key result to a goal. |
update_key_result | tulis | Changes a key result. |
delete_key_result | tulis | Deletes a key result and its check-ins. |
check_in | tulis | Records progress: a new value (with a note) on a key result, and/or a new status on the goal. |
link_goal | tulis | Links a project, epic, cycle or work item to a goal, or to a work-kind key result (its progress then counts that work). |
unlink_goal | tulis | Removes a goal or key-result link (linkId from get_goal). |
list_initiatives | baca | Lists workspace initiatives (efforts above projects and epics) with status, health and progress. |
get_initiative | baca | Reads one initiative with its linked projects, epics and goals, and optionally its status updates. |
create_initiative | tulis | Creates an initiative. |
update_initiative | tulis | Changes an initiative. |
delete_initiative | tulis | Deletes an initiative (linked projects, epics and goals stay). |
attach_to_initiative | tulis | Attaches a project, epic or goal to an initiative. |
detach_from_initiative | tulis | Detaches a project, epic or goal from an initiative. |
post_initiative_update | tulis | Posts a status update on an initiative; its health becomes the initiative's health. |
list_project_updates | baca | Lists the status updates (health posts) of a project, newest first, optionally with their comments. |
post_project_update | tulis | Posts a status update on a project with a health (on_track, at_risk, off_track). |
comment_project_update | tulis | Comments on a project status update (id from list_project_updates). |
list_notifications | baca | Lists your inbox notifications in a workspace (newest first, up to 200) and the unread count. |
update_notification | tulis | Marks a notification read or unread, archives or unarchives it, or snoozes it. |
mark_all_notifications_read | tulis | Marks every unread notification in a workspace as read. |
my_work_summary | baca | Your work overview in a workspace: counts of items you created, are assigned or subscribed to, by status category, priority and project. |
list_intake | baca | Lists intake requests of a project: open (pending/snoozed) or closed (accepted/declined/duplicate). |
create_intake | tulis | Files a request into a project's intake (triaged later into a work item). |
triage_intake | tulis | Decides an intake request: accept (creates a work item), decline, snooze, mark duplicate of a work item, or reopen. |
list_customers | baca | Lists the customers of a workspace with stage, owner and request counts. |
create_customer | tulis | Creates a customer. |
list_customer_requests | baca | Lists customer requests (feature asks, bugs) with linked work items, for one customer or the whole workspace. |
create_customer_request | tulis | Records a request from a customer, optionally linked to work items. |
link_customer_request | tulis | Links a work item to a customer request, or unlinks it. |
list_goals
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the goals (objectives) of a workspace with status, progress, owner and period.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
status | array<"on_track" / "at_risk" / "off_track" / "achieved" / "dropped"> | tidak | Only these statuses |
get_goal
Hanya baca. Bisa dipakai dengan token baca saja.
Reads one goal with its key results, links, sub-goals and optionally the check-in history.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
goal | string | ya | Goal id or exact title |
include_check_ins | boolean | tidak |
create_goal
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a goal (objective) for a period. Add key results with add_key_result. 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) |
title | string | ya | minimal 1 karakter |
start_on | string | ya | format YYYY-MM-DD |
end_on | string | ya | format YYYY-MM-DD |
description | string | tidak | Plain text |
status | "on_track" / "at_risk" / "off_track" / "achieved" / "dropped" | tidak | |
owner | string | tidak | Email or name; "me" for yourself |
parent | string | tidak | Parent goal id or title |
update_goal
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a goal. Only the fields given change; clear removes owner 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) |
goal | string | ya | Goal id or exact title |
title | string | tidak | minimal 1 karakter |
start_on | string | tidak | format YYYY-MM-DD |
end_on | string | tidak | format YYYY-MM-DD |
description | string | tidak | Plain text |
status | "on_track" / "at_risk" / "off_track" / "achieved" / "dropped" | tidak | |
owner | string | tidak | Email or name; "me" for yourself |
parent | string | tidak | Parent goal id or title |
clear | array<"owner" / "parent"> | tidak |
delete_goal
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a goal with its key results, check-ins and links. 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) |
goal | string | ya | Goal id or exact title |
add_key_result
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds a key result to a goal. Kinds: numeric (start->target), percentage, boolean, or work (progress computed from linked work; link it with link_goal). 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) |
goal | string | ya | Goal id or exact title |
title | string | ya | minimal 1 karakter |
kind | "numeric" / "percentage" / "boolean" / "work" | tidak | Default numeric |
start_value | number | tidak | numeric only |
target_value | number | tidak | numeric only |
current_value | number | tidak | numeric/percentage (0-100)/boolean (0 or 1) |
unit | string | tidak | e.g. %, users, $ (max 20 chars) |
update_key_result
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a key result. Prefer check_in to record progress. 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) |
key_result | string | ya | Key result id, or its title together with goal |
goal | string | tidak | Goal id or title, when key_result is a title |
title | string | tidak | minimal 1 karakter |
kind | "numeric" / "percentage" / "boolean" / "work" | tidak | |
start_value | number | tidak | numeric only |
target_value | number | tidak | numeric only |
current_value | number | tidak | numeric/percentage (0-100)/boolean (0 or 1) |
unit | string | tidak | e.g. %, users, $ (max 20 chars) |
delete_key_result
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a key result and its check-ins. 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) |
key_result | string | ya | Key result id, or its title together with goal |
goal | string | tidak |
check_in
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Records progress: a new value (with a note) on a key result, and/or a new status on the goal. Work-kind key results take their value from linked work. 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) |
goal | string | tidak | Goal id or title (needed for a status change, or to find a key result by title) |
key_result | string | tidak | Key result id or title |
value | number | tidak | New current value of the key result |
note | string | tidak | |
status | "on_track" / "at_risk" / "off_track" / "achieved" / "dropped" | tidak | New goal status |
link_goal
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Links a project, epic, cycle or work item to a goal, or to a work-kind key result (its progress then counts that work). 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) |
goal | string | tidak | Goal id or title |
key_result | string | tidak | Key result id or title (work kind); link to it instead of the goal |
kind | "project" / "epic" / "cycle" / "task" | ya | |
target | string | ya | Project key/name/id, work item reference (PROJ-12) or id, epic number/title/id, cycle name/id |
project | string | tidak | Project of the epic or cycle when target is not an id |
unlink_goal
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Removes a goal or key-result link (linkId from get_goal). Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
link_id | string | ya | linkId shown by get_goal; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
list_initiatives
Hanya baca. Bisa dipakai dengan token baca saja.
Lists workspace initiatives (efforts above projects and epics) with status, health and progress.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
status | array<"planned" / "active" / "completed" / "paused" / "cancelled"> | tidak |
get_initiative
Hanya baca. Bisa dipakai dengan token baca saja.
Reads one initiative with its linked projects, epics and goals, and optionally its status updates.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
initiative | string | ya | Initiative id or exact name |
include_updates | boolean | tidak |
create_initiative
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates an initiative. The lead defaults to you. 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) |
name | string | ya | minimal 1 karakter |
description | string | tidak | Plain text |
lead | string | tidak | Email or name; "me" for yourself |
status | "planned" / "active" / "completed" / "paused" / "cancelled" | tidak | |
health | "on_track" / "at_risk" / "off_track" | tidak | |
start_on | string | tidak | format YYYY-MM-DD |
target_on | string | tidak | format YYYY-MM-DD |
update_initiative
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes an initiative. Only the fields given change; clear empties lead or dates. 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) |
initiative | string | ya | Initiative id or exact name |
name | string | tidak | minimal 1 karakter |
description | string | tidak | Plain text |
lead | string | tidak | Email or name; "me" for yourself |
status | "planned" / "active" / "completed" / "paused" / "cancelled" | tidak | |
health | "on_track" / "at_risk" / "off_track" | tidak | |
start_on | string | tidak | format YYYY-MM-DD |
target_on | string | tidak | format YYYY-MM-DD |
clear | array<"lead" / "start_on" / "target_on"> | tidak |
delete_initiative
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes an initiative (linked projects, epics and goals stay). 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) |
initiative | string | ya | Initiative id or exact name |
attach_to_initiative
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Attaches a project, epic or goal to an initiative. 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) |
initiative | string | ya | Initiative id or exact name |
kind | "project" / "epic" / "goal" | ya | |
target | string | ya | Project key/name/id, epic number/title/id, or goal title/id |
project | string | tidak | Project of the epic when target is not an id |
detach_from_initiative
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Detaches a project, epic or goal from an initiative. 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) |
initiative | string | ya | Initiative id or exact name |
kind | "project" / "epic" / "goal" | ya | |
target | string | ya | Project key/name/id, epic number/title/id, or goal title/id |
project | string | tidak | Project of the epic when target is not an id |
post_initiative_update
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Posts a status update on an initiative; its health becomes the initiative's health. 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) |
initiative | string | ya | Initiative id or exact name |
health | "on_track" / "at_risk" / "off_track" | ya | |
text | string | ya | minimal 1 karakter |
list_project_updates
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the status updates (health posts) of a project, newest first, optionally with their comments.
| 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 |
limit | integer | tidak | Default 10; 1–100 |
include_comments | boolean | tidak |
post_project_update
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Posts a status update on a project with a health (on_track, at_risk, off_track). 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 |
health | "on_track" / "at_risk" / "off_track" | ya | |
text | string | ya | Plain text; blank lines start new paragraphs; minimal 1 karakter |
target_on | string | tidak | New target date for the project, if it moves; format YYYY-MM-DD |
comment_project_update
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Comments on a project status update (id from list_project_updates). Needs write access.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
update_id | string | ya | Update id from list_project_updates; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
text | string | ya | minimal 1 karakter |
list_notifications
Hanya baca. Bisa dipakai dengan token baca saja.
Lists your inbox notifications in a workspace (newest first, up to 200) and the unread count.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
filter | "unread" / "all" / "archived" / "snoozed" | tidak | Default unread |
kind | string | tidak | Only this notification kind, e.g. task_assigned, task_updated, project_update, initiative_update, chat_mention |
update_notification
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Marks a notification read or unread, archives or unarchives it, or snoozes it.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
id | string | ya | Notification id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
read | boolean | tidak | |
archived | boolean | tidak | |
snoozed_until | string / null | tidak | ISO date-time; null to unsnooze |
mark_all_notifications_read
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Marks every unread notification in a workspace as read.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
my_work_summary
Hanya baca. Bisa dipakai dengan token baca saja.
Your work overview in a workspace: counts of items you created, are assigned or subscribed to, by status category, priority and project.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
list_intake
Hanya baca. Bisa dipakai dengan token baca saja.
Lists intake requests of a project: open (pending/snoozed) or closed (accepted/declined/duplicate).
| 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 |
tab | "open" / "closed" | tidak | Default open |
search | string | tidak | Text in the title or requester |
create_intake
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Files a request into a project's intake (triaged later into 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) |
project | string | ya | Project key, id or name |
title | string | ya | minimal 1 karakter |
description | string | tidak | Plain text |
triage_intake
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Decides an intake request: accept (creates a work item), decline, snooze, mark duplicate of a work item, or reopen. 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) |
id | string | ya | Intake request id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
action | "accept" / "decline" / "snooze" / "duplicate" / "reopen" | ya | |
title | string | tidak | accept: work item title (default: request title) |
status | string | tidak | accept: status name or category |
priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | accept |
assignees | array<string> | tidak | accept: emails or names; "me" |
reason | string | tidak | decline: why |
until | string | tidak | snooze: ISO date-time in the future; pola ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ |
duplicate_of | string | tidak | duplicate: work item reference or id in the same project |
list_customers
Hanya baca. Bisa dipakai dengan token baca saja.
Lists the customers of a workspace with stage, owner and request counts.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
stage | array<"lead" / "prospect" / "active" / "churned"> | tidak |
create_customer
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a customer. The owner defaults to you. 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) |
name | string | ya | minimal 1 karakter |
email | string | tidak | |
website | string | tidak | |
stage | "lead" / "prospect" / "active" / "churned" | tidak | |
owner | string | tidak | Email or name; "me" |
employees | integer | tidak | 0–9007199254740991 |
revenue | number | tidak | min 0 |
notes | string | tidak |
list_customer_requests
Hanya baca. Bisa dipakai dengan token baca saja.
Lists customer requests (feature asks, bugs) with linked work items, for one customer or the whole workspace.
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
customer | string | tidak | Customer id or exact name |
status | array<"new" / "under_review" / "planned" / "done" / "declined"> | tidak |
create_customer_request
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Records a request from a customer, optionally linked to 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) |
customer | string | ya | Customer id or exact name |
title | string | ya | minimal 1 karakter |
description | string | tidak | |
status | "new" / "under_review" / "planned" / "done" / "declined" | tidak | |
source | "email" / "call" / "chat" / "other" | tidak | |
items | array<string> | tidak | Work item references or ids to link |
link_customer_request
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Links a work item to a customer request, or unlinks it. 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) |
request_id | string | ya | Customer request id; pola ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
item | string | ya | Work item reference or id |
unlink | boolean | tidak |