OpenAI 删除会话产物
2026-11-18 18:01 更新
delete /agents/sessions/{session_id}/artifacts/{artifact_id}
删除不可变会话产物。执行环境中的原文件和原始 Files API 对象均保留。参见会话产物。
路径参数
session_id: string
拥有此产物的会话 ID。
minLength: 0, maxLength: 1048576
artifact_id: string
不可变会话产物的 ID。
minLength: 0, maxLength: 1048576
返回值
SessionArtifactDeleted object { id, deleted, object }
不可变会话产物的删除确认。
id: string
已删除会话产物的 ID。
minLength: 0
deleted: boolean
会话产物是否已删除,恒为 true。
object: "agent.session.artifact.deleted" (default: "agent.session.artifact.deleted")
对象类型,固定为 agent.session.artifact.deleted。
"agent.session.artifact.deleted"
示例
## 从环境变量读取 API 密钥。
## 将 SESSION_ID 设置为目标会话的 ID。
## 将 ARTIFACT_ID 设置为目标产物的 ID。
curl https://api.openai.com/v1/agents/sessions/$SESSION_ID/artifacts/$ARTIFACT_ID \
-X DELETE \
-H 'OpenAI-Beta: agents=v1' \
-H "Authorization: Bearer $OPENAI_API_KEY"
200 响应示例
字段名、类型值和示例标识均按接口定义保留。
{
"id": "id",
"deleted": true,
"object": "agent.session.artifact.deleted"
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: