Submit a feedback ticket¶
Submit a problem description and optional conversation records to obtain a ticket ID/number, then track handling through your own ticket list. This creates a platform ticket, not a GitHub Issue.
POST https://api.moi.matrixorigin.cn/v5/feedback-tickets
Before you begin¶
Set MOI_ENDPOINT to the product API prefix https://api.moi.matrixorigin.cn/v5. For private deployments, use the corresponding product API URL.
Prepare a personal access token for the current environment and set MOI_ENDPOINT to an address including the API prefix. Current authentication determines ticket ownership; clients cannot supply account_id or uc_account_id. Runtime task proof does not replace regular authentication.
Request parameters¶
curl -X POST "$MOI_ENDPOINT/feedback-tickets" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{"title":"工作流发布后未找到API服务","description":"发布完成后,API服务列表没有出现对应服务。","expected_behavior":"可以在API服务列表找到新服务。","actual_behavior":"刷新列表后仍未找到。","reproduction_steps":"发布工作流后打开API服务列表。","suggested_priority":"请协助排查","messages":[{"role":"user","content":"发布后没有找到API服务。"}]}'
Parameter |
Type |
Required |
Description |
|---|---|---|---|
title |
string or null |
No |
Problem title. Recommended for identifying the ticket. |
description |
string or null |
No |
Problem description. |
expected_behavior |
string or null |
No |
Expected result. |
actual_behavior |
string or null |
No |
Actual result. |
reproduction_steps |
string or null |
No |
Reproduction steps. |
suggested_priority |
string or null |
No |
Suggested priority description. No fixed enum currently; does not directly set administrative handling state. |
messages |
object (array of objects) |
No |
Optional conversation records, up to 50. Omitted/null/empty array means no records. |
messages[].role |
string |
Yes |
user or assistant; system/tool rejected. |
messages[].content |
string |
Yes |
Cannot be whitespace-only. Up to 8000 Unicode characters, not UTF-8 bytes. |
Successful response¶
{
"code": 0,
"data": {
"id": "019a1234-1234-7123-8123-123456789abc",
"ticket_no": "FB-00000001",
"account_id": "principal-example",
"uc_account_id": null,
"title": "工作流发布后未找到API服务",
"description": "发布完成后,API服务列表没有出现对应服务。",
"expected_behavior": "可以在API服务列表找到新服务。",
"actual_behavior": "刷新列表后仍未找到。",
"reproduction_steps": "发布工作流后打开API服务列表。",
"suggested_priority": "请协助排查",
"status": "submitted",
"admin_reply": null,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z",
"messages": [
{
"sequence": 0,
"role": "user",
"content": "发布后没有找到API服务。",
"created_at": "2026-11-12T01:00:00Z"
}
]
}
}
Field |
Type |
Description |
|---|---|---|
code |
integer |
0 on success. No success msg field. |
data |
object |
Ticket object. Includes messages when present; otherwise omits messages. |
Error response¶
{"code":2,"message":"feedback ticket transcript is invalid"}
Field |
Type |
Description |
|---|---|---|
code |
integer |
Numeric handler errors:2 invalid request,5 denied,6 unauthenticated,15 dependency unavailable,1 internal error. Authentication middleware may return string code/msg; parse the actual envelope. |
message |
string |
Current handler error text; do not read it as msg. |
Save id/ticket_no after success. This request has no idempotency key; retrying after a network timeout may create another ticket. Check Your ticket list before deciding to resubmit.