---
title: "Cancel a response"
method: POST
path: "/v1/responses/{id}/cancel"
tags: ["responses"]
---

# Cancel a response

`POST /v1/responses/{id}/cancel`

## Path parameters

- `id` string, required

## Query parameters

- `provider` string

## Response `200`

OK

- CoreResponsesResponse
  - `created_at` integer
  - `error` CoreResponsesError
    - `code` string
    - `message` string
  - `id` string
  - `model` string
  - `object` string — "response"
  - `output` CoreResponsesOutputItem[]
    - `arguments` string
    - `call_id` string
    - `content` CoreResponsesContentItem[]
      - `annotations` object[] — Providers can return structured annotation objects here (for example citations from native tools), so keep the payload shape liberal.
      - `image_url` CoreImageURLContent
        - `detail` string
        - `media_type` string
        - `url` string
      - `input_audio` CoreInputAudioContent
        - `data` string
        - `format` string
      - `text` string
      - `type` string — "output_text", "input_image", "input_audio", etc.
    - `id` string
    - `name` string
    - `role` string
    - `status` string
    - `type` string — "message", "function_call", etc.
  - `provider` string
  - `status` string — "completed", "failed", "in_progress"
  - `usage` CoreResponsesUsage
    - `completion_tokens_details` CoreCompletionTokensDetails
      - `accepted_prediction_tokens` integer
      - `audio_tokens` integer
      - `reasoning_tokens` integer
      - `rejected_prediction_tokens` integer
    - `input_tokens` integer
    - `output_tokens` integer
    - `prompt_tokens_details` CorePromptTokensDetails
      - `audio_tokens` integer
      - `cached_tokens` integer
      - `image_tokens` integer
      - `text_tokens` integer
    - `raw_usage` object
    - `total_tokens` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `501` — Not Implemented
- `502` — Bad Gateway

## Changes

> 53 revisions in range; 2 could not be searched.

- **2026-08-22** `496ff50bdfef` — 5 info
  - added the optional property `error/provider` to the response with the `400` status
  - added the optional property `error/provider` to the response with the `401` status
  - added the optional property `error/provider` to the response with the `404` status
  - added the optional property `error/provider` to the response with the `501` status
  - …1 more
- **2026-04-19** `1a90f5d80e5a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/v1/responses/:id/cancel/post.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) · [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/enterpilot/gomodel-api/revisions/7b5727a74f59/schema)