# 删除 Response

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`DELETE https://ark.cn-beijing.volces.com/api/v3/responses/{responseId}`

本文介绍如何删除指定 ID 的 Response。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。

---

<span id="request-parameters"></span>
## 请求参数

### Path 参数

**responseId** `string` `必选` | Response ID

要删除的 Response ID

## 响应参数

**deleted** `boolean` | 是否删除成功

取值范围：
* `true`：删除成功。
* `false`：未删除成功

**id** `string` | Response ID

被删除的 Response ID

**object** `string` | 对象类型

固定为 `response`


## 代码示例

## 删除请求

### cURL


#### Request

```bash
RESP_ID="your_response_id"
curl -X DELETE "https://ark.cn-beijing.volces.com/api/v3/responses/$RESP_ID" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $ARK_API_KEY"
```
#### Response

```
{
  "id": "resp_0217******",
  "object": "response",
  "deleted": true
}
```

### Python-OpenAI


#### Request

```python
import os
from openai import OpenAI

# 从环境变量中获取您的API KEY，配置方法见：https://ark.volcengine.com/region:cn-beijing/docs/quick-start
api_key = os.getenv('ARK_API_KEY')

client = OpenAI(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=api_key,
)

if __name__ == "__main__":
    try:
        client.responses.delete(
            response_id="resp_0217*****"
        )
    except Exception as e:
        print(f"failed to delete response: {e}")
```

#### Response

```
{}
```

### Python


#### Request

```python
import os
from arkruntime import Ark

# 从环境变量中获取您的API KEY，配置方法见：https://ark.volcengine.com/region:cn-beijing/docs/quick-start
api_key = os.getenv('ARK_API_KEY')

client = Ark(
    base_url='https://ark.cn-beijing.volces.com/api/v3',
    api_key=api_key,
)

if __name__ == "__main__":
    try:
        client.responses.delete(
            response_id="resp_0217******"
        )
    except Exception as e:
        print(f"failed to delete response: {e}")
```

#### Response

```
{}
```

### Go


#### Request

```go
package main

import (
    "context"
    "fmt"
    "os"
    "github.com/volcengine/ark-runtime-go/arkruntime"
    "github.com/volcengine/ark-runtime-go/arkruntime/model/responses"
)

func main() {
    client := arkruntime.NewClientWithApiKey(
        os.Getenv("ARK_API_KEY"),
        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"),
    )
    ctx := context.Background()
    resp := client.DeleteResponse(ctx, &responses.ResponsesRemoveParams{ResponseId: "resp_0217*****"})
    fmt.Println()
    fmt.Println(resp)
}
```

#### Response

```
{}
```

### Java


#### Request

```java
package com.ark.example;
import com.volcengine.ark.runtime.service.ArkService;
import com.volcengine.ark.runtime.models.responses.*;
public class demo {
    public static void main(String[] args) {
        String apiKey = System.getenv("ARK_API_KEY");

        // 创建ArkService实例
        ArkService arkService = ArkService.builder().apiKey(apiKey)
                .baseUrl("https://ark.cn-beijing.volces.com/api/v3")
                .build();
        DeleteResponseResponse deleteResult = arkService.deleteResponse(
                DeleteResponseRequest.builder().responseId("resp_0217*****").build()
        );

        System.out.println(deleteResult);

        arkService.shutdownExecutor();
    }
}
```

#### Response

```
{}
```
