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.

Last updated on