# Compact conversation

`POST /v1/responses/compact`

The OpenAI Responses API endpoint that compacts a long conversation.

## Authorizations

Bearer authentication — send `Authorization: Bearer <token>`.

## Request Body (application/json) — required

```json
{
  "type": "object",
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string"
    },
    "input": {
      "description": "Input — either a string or an array of messages",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {}
          }
        }
      ]
    },
    "instructions": {
      "type": "string"
    },
    "previous_response_id": {
      "type": "string"
    }
  }
}
```

## Responses

### 200 — Conversation compacted

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "object": {
      "type": "string",
      "example": "response.compaction"
    },
    "created_at": {
      "type": "integer"
    },
    "output": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {}
      }
    },
    "usage": {
      "type": "object",
      "properties": {
        "prompt_tokens": {
          "type": "integer",
          "description": "Prompt tokens"
        },
        "completion_tokens": {
          "type": "integer",
          "description": "Completion tokens"
        },
        "total_tokens": {
          "type": "integer",
          "description": "Total tokens"
        },
        "prompt_tokens_details": {
          "type": "object",
          "properties": {
            "cached_tokens": {
              "type": "integer"
            },
            "text_tokens": {
              "type": "integer"
            },
            "audio_tokens": {
              "type": "integer"
            },
            "image_tokens": {
              "type": "integer"
            }
          }
        },
        "completion_tokens_details": {
          "type": "object",
          "properties": {
            "text_tokens": {
              "type": "integer"
            },
            "audio_tokens": {
              "type": "integer"
            },
            "reasoning_tokens": {
              "type": "integer"
            }
          }
        }
      }
    },
    "error": {
      "type": "object",
      "properties": {}
    }
  }
}
```