Struktur proyek
Status, label, tipe work item, custom field, template, otomasi, views, workflow, dan SLA.
Status, label, tipe work item, custom field, template, otomasi, views, workflow, dan SLA. Lihat Token dan izin untuk aturan akses.
| Tool | Jenis | Ringkasan |
|---|---|---|
list_statuses | baca | Lists a project's statuses in board order (grouped by category), with color and which one is the default for new items. |
create_status | tulis | Adds a status to a project. |
update_status | tulis | Renames, recolors or recategorizes a status, or makes it the default. |
reorder_statuses | tulis | Sets the order of a project's statuses. |
delete_status | tulis | Deletes a status. |
list_tags | baca | Lists tags (labels). |
create_tag | tulis | Creates a tag (label). |
update_tag | tulis | Renames or recolors a tag, or changes its parent (null removes the parent). |
delete_tag | tulis | Deletes a tag; it disappears from every work item that had it. |
merge_tags | tulis | Merges one tag into another: items with from get into, its child tags move under into, then from is deleted. |
create_work_item_type | tulis | Adds a work item type (e.g. |
update_work_item_type | tulis | Changes a work item type's name, description, icon or color, or makes it the default. |
delete_work_item_type | tulis | Deletes a work item type. |
create_custom_field | tulis | Adds a custom field definition to a project. |
update_custom_field | tulis | Changes a custom field definition. |
delete_custom_field | tulis | Deletes a custom field and every value stored in it. |
list_templates | baca | Lists a project's work item templates with their prefilled values. |
create_template | tulis | Creates a work item template: prefilled title, description, type, status, priority, tags and assignees. |
update_template | tulis | Changes a work item template; only given values change (type/status null clears them). |
delete_template | tulis | Deletes a work item template (items made from it are not affected). |
create_work_item_from_template | tulis | Creates a work item prefilled from a template. |
list_automation_rules | baca | Lists a project's automation rules (when <trigger> and <conditions> then <actions>) with names instead of ids and how often each ran. |
create_automation_rule | tulis | Creates an automation rule that runs after a work item is created or changed: when trigger happens (optionally narrowed by trigger_status/tag/person/priority) and every condition holds, the actions run once (they never trigger other rules). |
update_automation_rule | tulis | Changes an automation rule, or enables/disables it with enabled. |
delete_automation_rule | tulis | Deletes an automation rule. |
get_project_automations | baca | Reads a project's housekeeping automations: auto-archive items N days after they were closed, and auto-close items not updated for N months. |
set_project_automations | tulis | Sets housekeeping automations (checked hourly): archive done/dropped items N days after closing, and move items not updated for N months to a done/dropped status. null turns one off; omitted values stay. |
run_project_automations | tulis | Runs a project's housekeeping automations now instead of waiting for the hourly check, and says how many items were closed and archived. as_of evaluates as if today were that date (this really applies the changes). |
get_project_tracking | baca | Reads a project's tracking switches: time tracking on/off and whether a work item needs an approved request before it can be completed. |
set_project_tracking | tulis | Turns time tracking on/off and the require-approval-before-done rule (when on, moving an item to a done status fails until an approval request on it is approved; see request_approval). |
list_views | baca | Lists saved views: a project's views, or workspace-wide views when project is omitted. |
create_view | tulis | Saves a view of work items (filters + layout + display) for a project, or workspace-wide (across projects) when project is omitted. |
update_view | tulis | Changes a saved view. filters and display replace the old objects as a whole. |
delete_view | tulis | Deletes a saved view (work items are not affected). |
get_workflow | baca | Reads the allowed status transitions. |
set_workflow | tulis | Replaces one rule set of allowed status transitions: the project-wide set, or a work item type's own set. {} removes the set (everything allowed). |
get_sla | baca | Reads a project's SLA targets per priority: hours to first response (first comment by someone other than the creator) and to resolution. |
set_sla | tulis | Sets SLA targets for some priorities (others stay). |
list_statuses
Hanya baca. Bisa dipakai dengan token baca saja.
Lists a project's statuses in board order (grouped by category), with color and which one is the default for new items.
| 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 |
create_status
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds a status to a project. Category decides how it counts: backlog, todo, active, done (completes the item) or dropped. 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 | ya | minimal 1 karakter |
category | "backlog" / "todo" / "active" / "done" / "dropped" | ya | |
color | string | tidak | Default #8b8b8b; pola ^#[0-9a-fA-F]{6}$ |
default | boolean | tidak | Make it the status new items start in |
after | string | tidak | Place it right after this status; default is the end of its category |
update_status
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Renames, recolors or recategorizes a status, or makes it the default. 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 |
status | string | ya | Status name or id |
name | string | tidak | New name; minimal 1 karakter |
category | "backlog" / "todo" / "active" / "done" / "dropped" | tidak | |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
default | true | tidak | Make it the default status (the old default stops being one) |
reorder_statuses
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Sets the order of a project's statuses. List names in the wanted order; statuses left out keep their relative order after them. Order matters within a category. 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 |
order | array<string> | ya | Status names or ids |
delete_status
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a status. Items in it must move to another status (move_to). The default status cannot be deleted. Without confirm=true only shows what would be affected. 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 |
status | string | ya | Status name or id |
move_to | string | tidak | Status that its work items move to; required when it has items |
confirm | boolean | tidak | Must be true to actually delete |
list_tags
Hanya baca. Bisa dipakai dengan token baca saja.
Lists tags (labels). Without project: every tag of the workspace; with project: workspace-wide tags plus that project's own tags.
| 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 |
create_tag
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a tag (label). Workspace-wide by default; pass project for a tag only that project can use. 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 |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
project | string | tidak | Make it a project tag |
parent | string | tidak | Parent tag name or id, to nest it |
update_tag
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Renames or recolors a tag, or changes its parent (null removes the 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) |
tag | string | ya | Tag name or id |
project | string | tidak | Project whose tag is meant, when names repeat |
name | string | tidak | minimal 1 karakter |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
parent | string / null | tidak |
delete_tag
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a tag; it disappears from every work item that had it. Prefer merge_tags to keep the items tagged. 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) |
tag | string | ya | Tag name or id |
project | string | tidak | Project key, id or name |
merge_tags
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Merges one tag into another: items with from get into, its child tags move under into, then from is deleted. 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) |
from | string | ya | Tag to remove |
into | string | ya | Tag to keep |
project | string | tidak | Project key, id or name |
create_work_item_type
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds a work item type (e.g. Bug, Story) to a project. The project's first type becomes the default. 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 | ya | minimal 1 karakter |
description | string | tidak | |
icon | string | tidak | Icon name (lucide), default square-check |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
default | boolean | tidak | New items get this type |
update_work_item_type
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a work item type's name, description, icon or color, or makes it the default. 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 |
type | string | ya | Type name or id |
name | string | tidak | minimal 1 karakter |
description | string | tidak | |
icon | string | tidak | |
color | string | tidak | pola ^#[0-9a-fA-F]{6}$ |
default | true | tidak |
delete_work_item_type
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a work item type. Its items move to move_to, or lose their type. Without confirm=true only shows what would be affected. 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 |
type | string | ya | Type name or id |
move_to | string | tidak | Type its items get instead |
confirm | boolean | tidak | Must be true to actually delete |
create_custom_field
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Adds a custom field definition to a project. Kinds: text, number, date, select, multi_select (need options), checkbox, url, member. Set values with update_work_item_fields. 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 | ya | minimal 1 karakter |
kind | "text" / "number" / "date" / "select" / "multi_select" / "checkbox" / "url" / "member" | ya | |
description | string | tidak | |
options | array<object { label, color }> | tidak | select / multi_select choices |
types | array<string> | tidak | Work item type names it applies to; omit for all types |
required | boolean | tidak | Must be filled when an item is created |
visible | boolean | tidak | Shown as a column by default (default true) |
update_custom_field
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a custom field definition. The kind cannot change. Options: give options for the full new list, or add/remove/rename individual ones; options keep their identity by label, so values on items survive. Removing an option clears it from items. 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 |
field | string | ya | Field name or id |
name | string | tidak | minimal 1 karakter |
description | string | tidak | |
options | array<object { label, color }> | tidak | Full replacement list |
add_options | array<object { label, color }> | tidak | |
remove_options | array<string> | tidak | Labels to remove |
rename_options | object | tidak | Old label -> new label |
types | array<string> | tidak | Type names it applies to; [] = all types |
required | boolean | tidak | |
visible | boolean | tidak |
delete_custom_field
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a custom field and every value stored in it. Without confirm=true only shows what would be affected. 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 |
field | string | ya | Field name or id |
confirm | boolean | tidak | Must be true to actually delete |
list_templates
Hanya baca. Bisa dipakai dengan token baca saja.
Lists a project's work item templates with their prefilled 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 | ya | Project key, id or name |
create_template
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a work item template: prefilled title, description, type, status, priority, tags and assignees. 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 | ya | minimal 1 karakter |
description | string | tidak | What the template is for |
title | string | tidak | Prefilled work item title |
body | string | tidak | Prefilled description, plain text |
priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | |
tags | array<string> | tidak | Tag names |
assignees | array<string> | tidak | Emails or names; "me" for yourself |
type | string | tidak | Work item type name |
status | string | tidak | Status name |
update_template
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a work item template; only given values change (type/status null clears them). 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 |
template | string | ya | Template name or id |
name | string | tidak | minimal 1 karakter |
description | string | tidak | What the template is for |
title | string | tidak | Prefilled work item title |
body | string | tidak | Prefilled description, plain text |
priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | |
tags | array<string> | tidak | Tag names |
assignees | array<string> | tidak | Emails or names; "me" for yourself |
type | string / null | tidak | |
status | string / null | tidak |
delete_template
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a work item template (items made from it are not affected). 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 |
template | string | ya | Template name or id |
create_work_item_from_template
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates a work item prefilled from a template. Given values override the template's. 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 |
template | string | ya | Template name or id |
title | string | tidak | Required when the template has no title; minimal 1 karakter |
description | string | tidak | Replaces the template's description |
assignees | array<string> | tidak | |
tags | array<string> | tidak | Added to the template's tags |
due_on | string | tidak | format YYYY-MM-DD |
parent | string | tidak | Parent work item reference |
list_automation_rules
Hanya baca. Bisa dipakai dengan token baca saja.
Lists a project's automation rules (when <trigger> and <conditions> then <actions>) with names instead of ids and how often each ran.
| 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 |
create_automation_rule
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Creates an automation rule that runs after a work item is created or changed: when trigger happens (optionally narrowed by trigger_status/tag/person/priority) and every condition holds, the actions run once (they never trigger other rules). Example: trigger status_changed, trigger_status "Done", actions [{kind: add_label, value: "shipped"}]. 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 | ya | minimal 1 karakter |
trigger | "created" / "status_changed" / "assignee_changed" / "label_added" / "priority_changed" | ya | What happened to the work item |
trigger_status | string | tidak | status_changed: only when it moved to this status |
trigger_tag | string | tidak | label_added: only when this tag was added |
trigger_person | string | tidak | assignee_changed: only when this person was assigned |
trigger_priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | priority_changed: only when it changed to this priority |
conditions | array<object { field, op, values }> | tidak | All must hold, checked against the item after the change |
actions | array<object { kind, value, to }> | ya | |
enabled | boolean | tidak | Default true |
update_automation_rule
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes an automation rule, or enables/disables it with enabled. Given trigger (with its narrowing), conditions or actions replace the old ones. 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 |
rule | string | ya | Rule name or id |
name | string | tidak | minimal 1 karakter |
enabled | boolean | tidak | |
trigger | "created" / "status_changed" / "assignee_changed" / "label_added" / "priority_changed" | tidak | New trigger; the trigger_* narrowing given alongside replaces the old one |
trigger_status | string | tidak | status_changed: only when it moved to this status |
trigger_tag | string | tidak | label_added: only when this tag was added |
trigger_person | string | tidak | assignee_changed: only when this person was assigned |
trigger_priority | "none" / "low" / "medium" / "high" / "urgent" | tidak | priority_changed: only when it changed to this priority |
conditions | array<object { field, op, values }> | tidak | Replaces all conditions; [] removes them |
actions | array<object { kind, value, to }> | tidak | Replaces all actions |
delete_automation_rule
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes an automation rule. To pause it instead use update_automation_rule with enabled=false. 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 |
rule | string | ya | Rule name or id |
get_project_automations
Hanya baca. Bisa dipakai dengan token baca saja.
Reads a project's housekeeping automations: auto-archive items N days after they were closed, and auto-close items not updated for N months.
| 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_automations
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Sets housekeeping automations (checked hourly): archive done/dropped items N days after closing, and move items not updated for N months to a done/dropped status. null turns one off; omitted values stay. 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 |
auto_archive_days | integer / null | tidak | Days after closing (1-365) |
auto_close_months | integer / null | tidak | |
auto_close_status | string | tidak | Done or dropped status that stale items move to |
run_project_automations
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Runs a project's housekeeping automations now instead of waiting for the hourly check, and says how many items were closed and archived. as_of evaluates as if today were that date (this really applies the changes). 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 |
as_of | string | tidak | format YYYY-MM-DD |
get_project_tracking
Hanya baca. Bisa dipakai dengan token baca saja.
Reads a project's tracking switches: time tracking on/off and whether a work item needs an approved request before it can be completed.
| 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_tracking
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Turns time tracking on/off and the require-approval-before-done rule (when on, moving an item to a done status fails until an approval request on it is approved; see request_approval). Only the fields given change. 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 |
require_approval | boolean | tidak | |
time_tracking | boolean | tidak |
list_views
Hanya baca. Bisa dipakai dengan token baca saja.
Lists saved views: a project's views, or workspace-wide views when project is omitted. Private views of other people are not visible.
| 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 |
create_view
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Saves a view of work items (filters + layout + display) for a project, or workspace-wide (across projects) when project is omitted. 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 | tidak | Project key, id or name |
name | string | ya | minimal 1 karakter |
description | string | tidak | |
layout | "list" / "board" / "spreadsheet" / "calendar" / "gantt" | tidak | Default list |
filters | object | tidak | Filter object; every key optional: status (status names, project views only), category (backlog/todo/active/done/dropped), priority (none/low/medium/high/urgent), assignee and createdBy (people; "none" = unassigned), label (tag names), type (type names, "none"), project (project keys, workspace views), dueAfter/dueBefore/startAfter/startBefore/createdAfter/createdBefore (YYYY-MM-DD), q (text search), cf (custom field conditions: [{id: field id, op: in|contains|gte|lte|empty|not_empty, value}]). Names are turned into ids; ids pass through. |
display | object | tidak | Display object, stored as given: groupBy and subGroupBy (status, category, priority, assignee, label, type, project, none), orderBy (rank, created, updated, due, start, priority, title, number), desc, showSubItems, showEmptyGroups, properties (list of column keys). |
shared | boolean | tidak | Visible to others (default true); false = private to you |
update_view
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Changes a saved view. filters and display replace the old objects as a whole. Needs write access (and ownership for private views).
| Parameter | Tipe | Wajib | Keterangan |
|---|---|---|---|
workspace | string | tidak | Workspace slug or name; needed when the token reaches more than one (see list_workspaces) |
view | string | ya | View name or id |
project | string | tidak | Project of the view, when given by name |
name | string | tidak | minimal 1 karakter |
description | string | tidak | |
layout | "list" / "board" / "spreadsheet" / "calendar" / "gantt" | tidak | Default list |
filters | object | tidak | Filter object; every key optional: status (status names, project views only), category (backlog/todo/active/done/dropped), priority (none/low/medium/high/urgent), assignee and createdBy (people; "none" = unassigned), label (tag names), type (type names, "none"), project (project keys, workspace views), dueAfter/dueBefore/startAfter/startBefore/createdAfter/createdBefore (YYYY-MM-DD), q (text search), cf (custom field conditions: [{id: field id, op: in|contains|gte|lte|empty|not_empty, value}]). Names are turned into ids; ids pass through. |
display | object | tidak | Display object, stored as given: groupBy and subGroupBy (status, category, priority, assignee, label, type, project, none), orderBy (rank, created, updated, due, start, priority, title, number), desc, showSubItems, showEmptyGroups, properties (list of column keys). |
shared | boolean | tidak | Visible to others (default true); false = private to you |
delete_view
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Deletes a saved view (work items are not affected). 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) |
view | string | ya | View name or id |
project | string | tidak | Project key, id or name |
get_workflow
Hanya baca. Bisa dipakai dengan token baca saja.
Reads the allowed status transitions. A status with a rule may only move to the listed statuses; a status without one may move anywhere. Types with their own rules use those; other items use the project-wide rules.
| 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 |
type | string | tidak | Only this work item type's rules ('project' for the project-wide set) |
set_workflow
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Replaces one rule set of allowed status transitions: the project-wide set, or a work item type's own set. {} removes the set (everything allowed). 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 |
type | string | tidak | Work item type name for a type-specific set; omit for the project-wide set |
transitions | object | ya | From status -> statuses it may move to, e.g. {"Todo": ["In Progress"], "In Progress": ["Done", "Todo"]} |
get_sla
Hanya baca. Bisa dipakai dengan token baca saja.
Reads a project's SLA targets per priority: hours to first response (first comment by someone other than the creator) and to resolution.
| 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_sla
Menulis. Butuh token atau koneksi dengan akses Baca dan tulis.
Sets SLA targets for some priorities (others stay). Hours 1-8760; response cannot exceed resolution; both null removes the priority's target. Needs project admin and the Business plan feature "sla".
| 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 |
targets | array<object { priority, response_hours, resolution_hours }> | ya |