List administrative tickets

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

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

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

Request parameters

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"

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.

Successful response

{
  "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
  }
}

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

Error response

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

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 for the complete error families and stages.

Last updated on