<span id="提交反馈工单"></span>

# Submit a feedback ticket

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

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.

```text
POST https://api.moi.matrixorigin.cn/v5/feedback-tickets
```

<span id="调用前准备"></span>

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

<span id="请求参数"></span>

## Request parameters

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
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服务。"}]}'
```

:::::
:::::{tab-item} Parameters

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

:::::
::::::
:::::::

<span id="成功响应"></span>

## Successful response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "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"
      }
    ]
  }
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| code | integer | 0 on success. No success msg field. |
| data | object | [Ticket object](ticket-fields.md). Includes messages when present; otherwise omits messages. |

:::::
::::::
:::::::

<span id="错误响应"></span>

## Error response

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{"code":2,"message":"feedback ticket transcript is invalid"}
```

:::::
:::::{tab-item} Fields

| 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](list-my-tickets.md) before deciding to resubmit.
