Get administration ticket details¶
Read one ticket and its current messages, GitHub requests, and reward approval associations.
GET https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/{id}
Before you call this API¶
Prepare a Genesis administrator Bearer token valid for the current environment. An ordinary personal access token, X-API-Key, or Workspace Owner status is insufficient. Session-authenticated writes also require CSRF protection. See AI Studio. Replace example IDs with real tickets you are authorized to view.
Reading does not approve anything or publish an external Issue. Empty messages uses omitempty and may be omitted; it is not guaranteed to be an empty array.
Request parameters¶
curl -X GET "https://api.moi.matrixorigin.cn/v5/admin/feedback-tickets/ticket-example" \
-H "Authorization: Bearer $GENESIS_ADMIN_TOKEN"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes for the Bearer example |
Bearer followed by a trusted administrator token for this environment. Do not also set an API Key. |
|
string |
Yes |
Ticket ID in the path. |
Successful response¶
{
"code": 0,
"data": {
"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": []
},
"messages": [
{
"sequence": 0,
"role": "user",
"content": "示例反馈内容。",
"created_at": "2026-11-12T04:00:00Z"
}
]
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
Numeric 0 on success. |
|
object |
Ticket data. |
|
string |
Object ID. |
|
string / null |
Feedback number; may be null. |
|
string |
Product principal ID that submitted the ticket. |
|
string / null |
UC account facts saved at creation; may be null. This is not the current administrator’s account. |
|
object / null, optional |
Submitter information projected from the current identity directory for administrator reads. Optional; not persisted in the ticket. |
|
string / null |
Title; may be null on a ticket. |
|
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 establish triage. |
|
string |
Ticket state: submitted, processing, or closed. |
|
string / null |
Administrator reply; may be null. An empty string differs from null. |
|
string |
Creation time in RFC 3339. |
|
string |
Update time in RFC 3339. |
|
object (array of objects), optional |
Optional conversation records. Not loaded for lists; an empty collection in details may be omitted because of omitempty. |
|
object / null, optional |
Optional primary GitHub Issue request. Lists, details, and updates may all include this association. |
|
object / null, optional |
Optional reward approval facts. Not currently loaded for lists; returned by details and updates when present. |
See Shared objects for all public fields of nested tickets, users, messages, approval facts, and GitHub requests. Nullability and omission are documented separately; the old SDK fixture’s submitter_email is not a current field.
Error responses¶
{"code":"Unauthorized","msg":"Unauthorized"}
Field |
Type |
Description |
|---|---|---|
|
string / integer |
Varies by failure stage; the example uses an authentication-layer string. |
|
string |
Authentication or service-layer failure text; service text is usually localized. |
|
string |
Text for a numeric parameter-parsing error code; distinct from msg. |
|
null |
Current service-layer responseEnvelope errors retain null; authentication examples may omit this field. |
|
object |
Text-field 422 errors may include field/reason and other details; see the error descriptions. |
HTTP / code |
Conditions and handling |
|---|---|
401 / Unauthorized |
Rejected by authentication. Do not use an ordinary PAT or also supply X-API-Key. |
403 / ErrForbidden |
Trusted administrator eligibility was not obtained, or the current caller identity does not match it. |
404 / ErrFeedbackTicketNotFound |
The target ticket does not exist. Current service errors return code/msg/data:null. |
503 / ErrServiceUnavailable |
Classified identity, directory, or authorization dependency unavailability, or network timeout. |
500 / ErrServer |
Internal processing or localization failure. Read back after a write error to confirm the result. |
See Errors and recovery for all error families and stages.