<span id="查询管理工单列表"></span>

# List administrative tickets

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

Query feedback tickets across accounts, filtering by status, submitter, and search terms.

```text
GET https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets
```

<span id="调用前准备"></span>

## Before you call this API

Prepare a Genesis administrator Bearer token valid in this environment. Regular personal access tokens, X-API-Key, and Workspace Owner privileges do not substitute for it. Writes in session mode also require CSRF protection. See [AI Studio](../../../../../developer/api/ai-studio/index.md). Replace the example ID with a real ticket ID you are authorized to view.

github_issue_creation_available reflects deployment configuration only, not GitHub execution health. Lists do not load messages or reward events. A missing association does not prove approval never occurred.

<span id="请求参数"></span>

## Request parameters

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
curl --get "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets" \
  --data-urlencode "limit=50" \
  --data-urlencode "offset=0" \
  -H "Authorization: Bearer $GENESIS_ADMIN_TOKEN"
```

:::::
:::::{tab-item} Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `Authorization` | string | Yes for Bearer example | Bearer followed by a trusted administrator token for this environment. Do not also set an API Key. |
| `limit` | integer | No | Defaults to 50; range 1 to 100. Invalid values return 400/code:2/message. |
| `offset` | integer | No | Defaults to 0; nonnegative integer. |
| `status` | string | No | submitted, processing, or closed. Omit to skip this filter. |
| `account_id` | string | No | Exact match against the ticket account_id, not a UC ID. |
| `search` | string | No | Searches body facts or matching identity-directory entries. See common objects for coverage; not all fields are searchable. |

:::::
::::::
:::::::

<span id="成功响应"></span>

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "code": 0,
  "data": {
    "github_issue_creation_available": false,
    "items": [
      {
        "id": "ticket-example",
        "ticket_no": "FB-EXAMPLE",
        "account_id": "principal-example",
        "uc_account_id": "uc-example",
        "title": "示例反馈",
        "description": "界面显示结果与预期不同。",
        "expected_behavior": null,
        "actual_behavior": null,
        "reproduction_steps": null,
        "suggested_priority": null,
        "status": "submitted",
        "admin_reply": null,
        "created_at": "2026-11-12T04:00:00Z",
        "updated_at": "2026-11-12T04:00:00Z",
        "user_info": {
          "name": "示例用户",
          "accounts": []
        }
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | integer | Numeric 0 on success. |
| `data` | object | List data. |
| `data.github_issue_creation_available` | boolean | true when a creation workspace is configured in the deployment; not a health check of the full execution chain or permission validation. |
| `data.items` | object (array of objects) | Tickets on the current page; may be empty. |
| `data.total` | integer | Total tickets matching the filters. |
| `data.limit` | integer | Maximum items on the current page. |
| `data.offset` | integer | Current offset. |
| `data.items[].id` | string | Object ID. |
| `data.items[].ticket_no` | string / null | Feedback number; may be null. |
| `data.items[].account_id` | string | Product principal ID that submitted the ticket. |
| `data.items[].uc_account_id` | string / null | UC account fact saved at creation; may be null. Not the current administrator's account. |
| `data.items[].user_info` | object / null, optional | Submitter information projected from the current identity directory for administrative reads. May be omitted; not persisted in the ticket. |
| `data.items[].title` | string / null | Ticket title; may be null. |
| `data.items[].description` | string / null | Problem description; may be null. |
| `data.items[].expected_behavior` | string / null | Expected behavior; may be null. |
| `data.items[].actual_behavior` | string / null | Actual behavior; may be null. |
| `data.items[].reproduction_steps` | string / null | Reproduction steps; may be null. |
| `data.items[].suggested_priority` | string / null | User-suggested priority; may be null and does not indicate completed triage. |
| `data.items[].status` | string | Ticket state: submitted, processing, or closed. |
| `data.items[].admin_reply` | string / null | Administrator reply; may be null. Empty string and null are distinct. |
| `data.items[].created_at` | string | Creation time in RFC 3339. |
| `data.items[].updated_at` | string | Update time in RFC 3339. |
| `data.items[].messages` | object (array of objects), optional | Optional conversation records. Not loaded in lists; empty detail collections may be omitted through omitempty. |
| `data.items[].github_issue` | object / null, optional | Optional primary GitHub Issue request. Lists, details, and updates may include this association. |
| `data.items[].reward_event` | object / null, optional | Optional reward approval fact. Currently not loaded in lists; details and updates return it when present. |

See [Common objects](objects.md) for all public fields of nested tickets, users, messages, approval facts, and GitHub requests. Nullability and omission are listed separately. submitter_email in old SDK fixtures is not a current field.
:::::
::::::
:::::::

<span id="错误响应"></span>

## Error response

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{"code":"Unauthorized","msg":"Unauthorized"}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `code` | string / integer | Varies by failure stage; the example uses an authentication-layer string. |
| `msg` | string | Authentication or service failure text; service text is usually localized. |
| `message` | string | Text for numeric error codes during parameter parsing, distinct from msg. |
| `data` | null | Current service responseEnvelope errors retain null; authentication examples may omit this field. |
| `details` | object | Text-field 422 errors may include field/reason and other details; see errors. |

| HTTP / code | Conditions and recovery |
| --- | --- |
| 401 / Unauthorized | Authentication rejected. Do not use a regular PAT or also send X-API-Key. |
| 403 / ErrForbidden | Trusted administrator facts were not obtained, or the calling identity does not match them. |
| 404 / ErrFeedbackTicketNotFound | Ticket not found. Current service errors return code/msg/data:null. |
| 503 / ErrServiceUnavailable | Classified identity, directory, or authorization dependency unavailable, or network timeout. |
| 500 / ErrServer | Internal processing or localization failure. Read again to confirm after a write error. |

See [Errors and recovery](errors-recovery.md) for the complete error families and stages.
:::::
::::::
:::::::
