# Meegle API Views Measurement > Meegle OpenAPI for views, kanban, Gantt, and measurement/charts. - Skill: `dvcrn/meegle-api-views-measurement` (Agent Skill) - Install (CLI): `npx skillmds@latest add dvcrn/meegle-api-views-measurement` - Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/meegle-api-views-measurement/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs - Author: dvcrn (https://skillmd.com/u/dvcrn) - Updated: 2026-09-08 - Page: https://skillmd.com/skills/dvcrn/meegle-api-views-measurement --- # Meegle API — Views & Measurement Views, boards, and measurement OpenAPIs: list views, work items in views, create/update/delete views, chart data. --- ## Get the List of Views and Settings Search for the list of views that meet the request parameters and related configuration in the specified space. Response follows FixView format (view_id, name, view_type, auth, collaborators, created_at, created_by, quick_filters, system_view, view_url, etc.). Permission: Permission Management – Views. For details, see Permission Management. ### When to Use - When listing or searching views by work item type (e.g. story, issue) with optional filters (view_name, view_ids, created_by, created_at) - When you need **view_id**, **view_url**, or **quick_filters** for Get the List of Work Items in Views or for view management UIs - When paginating view results (**page_size** max 10, **page_num**); set **is_query_quick_filter** true to include quick filter conditions in the response ### API Spec: get_list_of_views_and_settings ```yaml name: get_list_of_views_and_settings type: api description: List views by work_item_type_key and filters; FixView list with pagination; page_size max 10. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/{project_key}/view_conf/list" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: { type: string, required: true } } inputs: { work_item_type_key: string, view_name: string, view_ids: array, created_by: string, created_at: object, page_size: { default: 10, max: 10 }, page_num: integer, is_query_quick_filter: boolean } outputs: { data: array, pagination: object } constraints: [Permission: Views] error_mapping: { 30004: View not exist, 30014: WorkItem type not found, 50006: Miss params } ``` ### Usage notes - **work_item_type_key**: Required; get from Get work item types in space. **sub_task** is not supported. - **view_ids** vs **view_name**: If **view_ids** is set, only those views are returned and **view_name** is ignored. **created_by** applies in AND with view_name/view_ids. - **created_at**: Time range; omit **end** for "up to now". Timestamps in milliseconds. - **data** items: Use **view_id** for Get the List of Work Items in Views or update/delete view APIs. **quick_filters** is populated when **is_query_quick_filter** is true. - **pagination**: total, page_num, page_size for paging. --- ## Get the List of Work Items in Views Obtain the list of all work item instances in the specified (fixed) view. Response includes view metadata (name, view_id, editable, created_at, created_by, modified_by) and **work_item_id_list**. Permission: Permission Management – View. For details, see Permission Management. ### When to Use - When listing work items displayed in a fixed view by **view_id** (from Get the List of Views and Settings or from the view page URL) - When paginating work item IDs (**page_size** max 200, **page_num**); use **quick_filter_id** to filter by a quick filter from the view list interface - Panorama (multi-project) view is not supported; use Get the List of Work Items in Views (Panorama View) for that case ### API Spec: get_list_of_work_items_in_views ```yaml name: get_list_of_work_items_in_views type: api description: Work items in fixed view; view info + work_item_id_list; panorama not supported (use panorama API). auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: GET, url: "https://{domain}/open_api/{project_key}/fix_view/{view_id}" } headers: { X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, view_id: string } inputs: { page_size: { max: 200 }, page_num: { default: 1 }, quick_filter_id: string } outputs: { data: object, pagination: object } constraints: [Permission: View] error_mapping: { 30004: View not exist, 50006: Too many docs or multiProjectView, 20012: View not in project, 30014: Work item type not found } ``` ### Usage notes - **view_id**: From the view page URL (e.g. `.../storyView/RHCFGTzDa` → view_id `RHCFGTzDa`) or from **Get the List of Views and Settings** (data[].view_id). - **work_item_id_list**: List of work item IDs shown in this view; use these IDs with work item APIs to get full details. - **quick_filter_id**: Optional; from **Get the List of Views and Settings** with **is_query_quick_filter** true (data[].quick_filters[].quick_filter_id). - Query result cap: if the view would return more than 200,000 docs, 50006 is returned; narrow with **quick_filter_id** or other filters. - **20012**: The view belongs to a different space than **project_key**; use the correct space. - Panorama view: this interface returns 50006 for multi-project view; use **Get the List of Work Items in Views (Panorama View)** for that scenario. --- ## Get the List of Work Items in Views (Panorama View) Obtain the list and detailed information of all work item instances in the specified panoramic (multi-project) view. Response follows WorkItemInfo (id, name, work_item_type_key, project_key, simple_name, template_id, template, pattern, sub_stage, work_item_status, current_nodes, state_times, created_by, updated_by, created_at, updated_at, fields). Permission: Permission Management – Views. For details, see Permission Management. ### When to Use - When listing work items in a **panorama view** (multi-project view); use this API instead of Get the List of Work Items in Views (which returns 50006 for panorama view) - When you need full work item detail per item (WorkItemInfo with fields, current_nodes, state_times) rather than only IDs - When paginating with **page_size** max 50 and optional **quick_filter_id** from the view list interface ### API Spec: get_list_of_work_items_in_views_panorama ```yaml name: get_list_of_work_items_in_views_panorama type: api description: Work items in panorama view; full WorkItemInfo per item; page_size max 50. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/{project_key}/view/{view_id}" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, view_id: string } inputs: { page_size: { max: 50 }, page_num: { default: 1 }, quick_filter_id: string } outputs: { data: array, pagination: object } constraints: [Permission: Views, panorama only] error_mapping: { 30004: View not exist, 20003: Wrong WorkItemType param } ``` ### Usage notes - **view_id**: From the view page URL or from **Get the List of Views and Settings** (data[].view_id). Must be a panorama view; for fixed views use Get the List of Work Items in Views. - **data**: Each element is full **WorkItemInfo** (id, name, work_item_type_key, project_key, simple_name, template, pattern, sub_stage, current_nodes, state_times, fields, etc.) — no need to call work item detail API per ID for basic display. - **page_size**: Max 50 (smaller than the fixed-view API’s 200). - **quick_filter_id**: Optional; from **Get the List of Views and Settings** with **is_query_quick_filter** true. - **20003**: When the API requires a work item type filter for the specified list, ensure the required parameter (e.g. work_item_type_key) is provided per product behavior. --- ## Create a Fixed View Add a fixed view under the specified space and work item type. Request supplies **work_item_id_list** (max 200), **name**, and optional collaboration settings. Returns the newly created view (FixView: view_id, name, work_item_id_list, editable, created_by, created_at, modified_by) and pagination. Permission: Permission Management – Views & Metrics. For details, see Permission Management. ### When to Use - When creating a new fixed view for a work item type (e.g. story) with a chosen list of work item IDs - When setting **cooperation_mode** (1: specified users/teams, 2: all space admins, 3: all space members) and optionally **cooperation_user_keys** / **cooperation_team_ids** - When you need the returned **view_id** for Get the List of Work Items in Views or Update/Delete Views ### API Spec: create_fixed_view ```yaml name: create_fixed_view type: api description: Create fixed view; work_item_id_list max 200, name; returns FixView + pagination. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/{project_key}/{work_item_type_key}/fix_view" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, work_item_type_key: string } inputs: { work_item_id_list: { type: array, required: true, max: 200 }, name: string, cooperation_mode: integer, cooperation_user_keys: array, cooperation_team_ids: array } outputs: { data: object, pagination: object } constraints: [Permission: Views & Metrics] error_mapping: { 30005: WorkItem not found, 1000053645: Ids limit 200, 50006: Invalid params, 20010: WorkItemType not same, 30004: View not found } ``` ### Usage notes - **work_item_id_list**: Must be valid work item IDs under the space; max **200** items. All must match **work_item_type_key** (20010 otherwise). Invalid IDs return 30005. - **cooperation_mode** **1**: Provide **cooperation_user_keys** and/or **cooperation_team_ids**; user_key from double-click avatar in space or Search user list within tenant; team_id from Get team members in the space. - **data.view_id**: Use for Get the List of Work Items in Views, Update a Fixed View, or Delete Views. - **50006**: Request is invalid when **work_item_id_list** is missing. --- ## Update a Fixed View Add or remove work item instances in a specified fixed view. Send either **add_work_item_ids** or **remove_work_item_ids** (not both, not both empty); each list has a maximum of 200 items. On success, **data** is null. Permission: Permission Management – Views & Metrics. For details, see Permission Management. ### When to Use - When adding work items to an existing fixed view (**add_work_item_ids**) or removing them (**remove_work_item_ids**) - When **view_id** comes from Get the List of Views and Settings or Create a Fixed View - One operation per request: either add or remove, not both; at least one of the two lists must be non-empty ### API Spec: update_fixed_view ```yaml name: update_fixed_view type: api description: Add or remove work items in fixed view; one of add_work_item_ids or remove_work_item_ids (max 200 each). auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/{project_key}/{work_item_type_key}/fix_view/{view_id}" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, work_item_type_key: string, view_id: string } inputs: { add_work_item_ids: { type: array, max: 200 }, remove_work_item_ids: { type: array, max: 200 } } outputs: { data: object } constraints: [Permission: Views & Metrics, exactly one of add/remove non-empty] error_mapping: { 30004: View not exist, 20005: Missing param, 1000053645: Ids limit 200, 10001: No permission } ``` ### Usage notes - **view_id**: From the view page URL or from **Get the List of Views and Settings** / **Create a Fixed View** (data.view_id). - **add_work_item_ids** vs **remove_work_item_ids**: Pass **only one** of them per request, and it must be **non-empty**. Passing both or both empty returns 20005. - Each list: max **200** IDs per request (1000053645 if exceeded). IDs in **add_work_item_ids** must exist (20005 “has no workitems” otherwise). - **10001**: Caller does not have permission to modify this view. --- ## Create a Conditional View Add a new conditional view under the specified space and work item type. Request includes **search_group** (filter conditions: conjunction, search_params with param_key, value, operator). Returns **view_id**. Permission: Permission Management – Views. For details, see Permission Management. ### When to Use - When creating a conditional view (filter-based) for a work item type with **search_group** (AND/OR and search_params) - When setting **cooperation_mode** (1: specified users/teams, 2: all space admins, 3: all space members) and optionally **cooperation_user_keys** / **cooperation_team_ids** - When you need the returned **view_id** for Get the List of Work Items in Views or Update/Delete Views ### API Spec: create_conditional_view ```yaml name: create_conditional_view type: api description: Create conditional view; project_key (no simple_name), work_item_type_key, name, search_group (conjunction, search_params); returns view_id. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/view/v1/create_condition_view" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } inputs: { project_key: string, work_item_type_key: string, name: string, search_group: object, cooperation_mode: integer, cooperation_user_keys: array, cooperation_team_ids: array } outputs: { data: { view_id: string } } constraints: [Permission: Views, project_key only no simple_name] error_mapping: { 20029: Unsupported field type, 50006: Invalid params } ``` ### Usage notes - **project_key**: Must be the space **project_key** (double-click space name); **simple_name** (space domain name) is **not** supported for this API. - **search_group**: **conjunction** (e.g. `"AND"`) and **search_params** (each with **param_key**, **value**, **operator** such as `"="`). **param_key** must be a supported field (20029 if invalid). For date/date+time fields use **UTC** format (e.g. `2024-09-01T00:00:00+07:00`); filtering is at **day** level only (hour/minute/second not supported). - **data.view_id**: Use for Get the List of Work Items in Views, Update a Conditional View, or Delete Views. - **cooperation_mode** **1**: Provide **cooperation_user_keys** and/or **cooperation_team_ids** as for Create a Fixed View. --- ## Update a Conditional View Update the filtering conditions and collaborator information of a specified conditional view. Request includes **view_id**, **search_group** (required), and optional **name**, **cooperation_mode**, **cooperation_user_keys**, **cooperation_team_ids**. On success, no data body is returned (err_code 0). Permission: Permission Management – Views. For details, see Permission Management. ### When to Use - When changing filter conditions (**search_group**) or collaboration settings of an existing conditional view - When **view_id** is from the conditional view (e.g. from Create a Conditional View or from browser URL suffix such as .../multiProjectView/view_text → view_id "view_text") - When renaming the view (**name**) or updating who can collaborate (**cooperation_mode**, **cooperation_user_keys**, **cooperation_team_ids**) ### API Spec: update_conditional_view ```yaml name: update_conditional_view type: api description: Update conditional view; project_key, work_item_type_key, view_id (from browser URL suffix), search_group required. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/view/v1/update_condition_view" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } inputs: { project_key: string, work_item_type_key: string, view_id: string, search_group: object, name: string, cooperation_mode: integer, cooperation_user_keys: array, cooperation_team_ids: array } outputs: { data: object } constraints: [Permission: Views, project_key only, view_id from URL suffix] error_mapping: { 20029: Unsupported field type, 50006: Invalid params, 30004: View not exist } ``` ### Usage notes - **view_id**: For this API, **view_id** is currently only obtainable from the **browser URL suffix** (e.g. URL `.../multiProjectView/view_text` → view_id `"view_text"`). Use the correct view_id or 30004 is returned. - **project_key**: Must be space **project_key**; **simple_name** is not supported. - **search_group**: Same structure as Create a Conditional View (conjunction, search_params); date fields in UTC, day-level only. Unsupported field types return 20029. - Success: no **data** in response; **err_code** 0 indicates success. --- ## Delete Views Delete a view from the specified space. Supports **conditional**, **fixed**, and **panoramic** views. Request is DELETE with **project_key** and **view_id** in path. On success, no data body is returned (err_code 0). Permission: Permission Management – Views & Metrics. For details, see Permission Management. ### When to Use - When removing a view (fixed, conditional, or panorama) from the space - When **view_id** comes from Get the List of Views and Settings, Create a Fixed View, Create a Conditional View, or the view page URL ### API Spec: delete_views ```yaml name: delete_views type: api description: Delete view (fixed/conditional/panorama); path project_key, view_id. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: DELETE, url: "https://{domain}/open_api/{project_key}/fix_view/{view_id}" } headers: { X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, view_id: string } outputs: { data: object } constraints: [Permission: Views & Metrics] error_mapping: { 30004: View not found } ``` ### Usage notes - **view_id**: From the view page URL (e.g. `.../storyView/RHCFGTzDa` → view_id `RHCFGTzDa`) or from **Get the List of Views and Settings** (data[].view_id), **Create a Fixed View** (data.view_id), or **Create a Conditional View** (data.view_id). - **project_key**: May be space **project_key** or **simple_name** (unlike Create/Update Conditional View). - Applies to all view types: fixed view, conditional view, and panoramic view. - Success: no **data** in response; **err_code** 0 indicates success. --- ## Get Detailed Data from Charts Retrieve the detailed data of a specified metric chart. Request is GET with **project_key** and **chart_id** in path. Response returns chart data (name, chart_id, chart_data_list with dim/value/is_zero_spec, dim_titles, quota_titles). Permission: Permission Management – Metrics & Views. For details, see Permission Management. ### Instructions - **chart_id**: Obtain from the **browser URL** of the chart page. - **Timeout**: Some metric charts are complex and require long computation; set **HTTP timeout to more than 60 seconds**. - **Concurrency**: Metric rate limiting applies. **Control concurrency to 1** — use single-threaded serial calls on a single machine; otherwise you may be rate-limited. ### When to Use - When fetching chart data for a specific metric chart by **chart_id** (from browser URL or Query all charts by view ID) - When building dashboards or reporting that display chart dimensions and quota values ### API Spec: get_detailed_data_from_charts ```yaml name: get_detailed_data_from_charts type: api description: Chart detail by chart_id (from browser URL); chart_data_list, dim_titles, quota_titles; timeout >60s, concurrency 1. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: GET, url: "https://{domain}/open_api/{project_key}/measure/{chart_id}" } headers: { X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } path_params: { project_key: string, chart_id: string } outputs: { data: object } constraints: [Permission: Metrics & Views] error_mapping: { 50006: Chart config error, 500006: chart_id invalid or deleted } ``` ### Usage notes - **chart_id**: From the **browser URL** when viewing the chart, or from **Query all charts by view ID**. - **data.chart_data_list**: Array of data points; each has **dim** (dimension key-value), **value** (quota key-value), **is_zero_spec**. **dim_titles** and **quota_titles** describe axis labels. - **50006 / 1000051872**: Chart configuration has an exception; check for configurations marked in red in the product and adjust. - **500006 / 1000050535**: **chart_id** is invalid or the chart was deleted; confirm chart_id and that the chart exists. --- ## Query all charts by view ID Query all metric charts under a space view. Request is POST with **project_key** and **view_id** in body; optional **page_num** (default 1) and **page_size** (max 200, default 50). Response returns **chart_list** (chart_id, chart_name per chart) and **chart_page** (total, page_num, page_size). Permission: Permission Management – Views & analytics. For details, see Permission Management. ### When to Use - When listing all metric charts under a view by **view_id** (from Get the List of Views and Settings or the view page URL) - When you need **chart_id** and **chart_name** for each chart (e.g. to call Get Detailed Data from Charts) - When paginating chart results (**page_size** max 200) ### API Spec: query_all_charts_by_view_id ```yaml name: query_all_charts_by_view_id type: api description: List charts under view; project_key, view_id; page_size max 200 default 50; returns chart_list, chart_page. auth: { type: plugin_access_token, header: X-Plugin-Token, user_header: X-User-Key } http: { method: POST, url: "https://{domain}/open_api/measure/charts" } headers: { Content-Type: application/json, X-Plugin-Token: "{{resolved_token}}", X-User-Key: "{{user_key}}" } inputs: { project_key: string, view_id: string, page_num: { default: 1 }, page_size: { default: 50, max: 200 } } outputs: { data: { chart_list: array, chart_page: object } } constraints: [Permission: Views & analytics] error_mapping: { 1000051401: Invalid parameter } ``` ### Usage notes - **view_id**: From the view page URL (e.g. `.../storyView/RHCFGTzDa`) or from **Get the List of Views and Settings** (data[].view_id). - **data.chart_list**: Each item has **chart_id** and **chart_name**; use **chart_id** with **Get Detailed Data from Charts** to fetch chart detail. - **data.chart_page**: **total** (total pages or total count per product), **page_num**, **page_size** for pagination. - **1000051401**: Invalid or unreasonable input parameters; verify project_key and view_id.