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 |
|---|---|---|---|
|
string |
Yes for Bearer example |
Bearer followed by a trusted administrator token for this environment. Do not also set an API Key. |
|
integer |
No |
Defaults to 50; range 1 to 100. Invalid values return 400/code:2/message. |
|
integer |
No |
Defaults to 0; nonnegative integer. |
|
string |
No |
submitted, processing, or closed. Omit to skip this filter. |
|
string |
No |
Exact match against the ticket account_id, not a UC ID. |
|
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 |
|---|---|---|
|
integer |
Numeric 0 on success. |
|
object |
List data. |
|
boolean |
true when a creation workspace is configured in the deployment; not a health check of the full execution chain or permission validation. |
|
object (array of objects) |
Tickets on the current page; may be empty. |
|
integer |
Total tickets matching the filters. |
|
integer |
Maximum items on the current page. |
|
integer |
Current offset. |
|
string |
Object ID. |
|
string / null |
Feedback number; may be null. |
|
string |
Product principal ID that submitted the ticket. |
|
string / null |
UC account fact saved at creation; may be null. Not the current administrator’s account. |
|
object / null, optional |
Submitter information projected from the current identity directory for administrative reads. May be omitted; not persisted in the ticket. |
|
string / null |
Ticket title; may be null. |
|
string / null |
Problem description; may be null. |
|
string / null |
Expected behavior; may be null. |
|
string / null |
Actual behavior; may be null. |
|
string / null |
Reproduction steps; may be null. |
|
string / null |
User-suggested priority; may be null and does not indicate completed triage. |
|
string |
Ticket state: submitted, processing, or closed. |
|
string / null |
Administrator reply; may be null. Empty string and null are distinct. |
|
string |
Creation time in RFC 3339. |
|
string |
Update time in RFC 3339. |
|
object (array of objects), optional |
Optional conversation records. Not loaded in lists; empty detail collections may be omitted through omitempty. |
|
object / null, optional |
Optional primary GitHub Issue request. Lists, details, and updates may include this association. |
|
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 |
|---|---|---|
|
string / integer |
Varies by failure stage; the example uses an authentication-layer string. |
|
string |
Authentication or service failure text; service text is usually localized. |
|
string |
Text for numeric error codes during parameter parsing, distinct from msg. |
|
null |
Current service responseEnvelope errors retain null; authentication examples may omit this field. |
|
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.