チケットを更新
このエンドポイントでは、チケット情報を更新できます。
リクエストメソッド
PUT
エンドポイント
https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id
認証
詳細は、API Overview の認証方法に関する説明を参照してください。
リクエスト
リクエスト例
curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"title": "Printer jammed and unable to print (updated)",
"description": "The customer reported that A4 paper is jammed in the output tray and needs urgent handling.\nA technician has been dispatched.",
"attachments": [
{
"file_url": "https://example.com/files/error-photo.jpg"
}
],
"priority": "normal",
"ticket_type": "incident",
"custom_fields": {
"department": "IT Support",
"device_sn": "PRN-2024-001",
"location": "Beijing Headquarters - 3rd Floor Print Room",
"resolution_note": "Replaced the paper feeder"
},
"tags": ["printer", "hardware", "resolved"]
}'
curl -X PUT 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets/:ticket_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
"title": "Printer jammed and unable to print (updated)",
"description": "The customer reported that A4 paper is jammed in the output tray and needs urgent handling.\nA technician has been dispatched.",
"attachments": [
{
"file_url": "https://example.com/files/error-photo.jpg"
}
],
"priority": "normal",
"ticket_type": "incident",
"custom_fields": {
"department": "IT Support",
"device_sn": "PRN-2024-001",
"location": "Beijing Headquarters - 3rd Floor Print Room",
"resolution_note": "Replaced the paper feeder"
},
"tags": ["printer", "hardware", "resolved"]
}'
このコードブロックはフローティングウィンドウ内に表示されます
リクエストヘッダー
| Field | Type | Description |
|---|---|---|
| Authorization | string | 認証には Authorization: Basic base64(API Key:API Secret) を使用します。API キーページで API Key と API Secret を取得し、コロンで連結したうえで、その結果を Base64 エンコードしてください。 |
| Content-Type | application/json | データ形式。値は application/json です。 |
パスパラメータ
| Field | Type | Required | Description |
|---|---|---|---|
| ticket_id | String | Yes | チケット ID。 |
リクエストボディパラメータ
| Field | Type | Required | Description |
|---|---|---|---|
| title | String | Yes | チケットのタイトル。 |
| description | String | Yes | チケットの詳細説明（Markdown をサポート）。 |
| attachments | Array | No | チケットレベルの添付ファイル一覧。file_url: ファイルの URL。 |
| priority | String | No | 優先度。low / medium / high / urgent。未指定の場合のデフォルト値は medium です。 |
| ticket_type | String | No | チケットタイプ。incident / question / problem / task。 |
| custom_fields | Object | No | デバイスのシリアル番号や注文番号などを格納するカスタムフィールド。 |
| tags | Array | No | チケットタグ。 |
レスポンス
成功レスポンス
{
"code": 0,
"message": "Success",
"data": {
"ticket_id": "tk_20251104_789abc",
"updated_at": "2025-11-04T10:30:00+08:00"
}
}
{
"code": 0,
"message": "Success",
"data": {
"ticket_id": "tk_20251104_789abc",
"updated_at": "2025-11-04T10:30:00+08:00"
}
}
このコードブロックはフローティングウィンドウ内に表示されます
レスポンスパラメータ
| Field | Type | Required | Description |
|---|---|---|---|
| ticket_id | String | No | チケット ID。 |
| updated_at | String | No | 更新日時。 |
