---
title: "Add followup"
method: POST
path: "/v0/agents/{id}/followup"
---

# Add followup

`POST /v0/agents/{id}/followup`

## Request

- Base URL: `https://api.cursor.com`
- URL: `https://api.cursor.com/v0/agents/{id}/followup`
- Auth: HTTP bearer

Add a followup instruction to an existing cloud agent

## Path parameters

- `id` string, required

## Request body

- object
  - `prompt` object, required
    - `text` string, required: The followup instruction for the agent
    - `images` Image[]: Optional array of base64 encoded images (max 5)
      - `data` string, required: Base64 encoded image data
      - `dimension` ImageDimension
        - `width` integer, required: Width must be a positive integer
        - `height` integer, required: Height must be a positive integer

## Response `200`

Followup added successfully

- object
  - `id` string, required: Unique identifier for the cloud agent

## Other responses

- `400`: Invalid request - bad agent ID format or invalid request body
- `401`: Unauthorized - invalid or missing API key
- `403`: Forbidden - insufficient permissions
- `404`: Agent not found or access denied
- `409`: Conflict - agent is deleted or archived
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api.md) - [All operations](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cursor/apis/cursor-cloud-agents-api/revisions/62c9131c7ea0?raw)