---
title: "Pin or unpin a response"
method: PUT
path: "/surveys/{id}/responses/{responseId}/pin"
tags: ["Responses"]
---

# Pin or unpin a response

`PUT /surveys/{id}/responses/{responseId}/pin`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/surveys/{id}/responses/{responseId}/pin`
- Auth: HTTP bearer

Pins or unpins an individual response on a survey. Pinned responses are marked as noteworthy for easy retrieval. This is idempotent — pinning an already-pinned response returns 200 with the same state.

## Path parameters

- `id` string, required
- `responseId` string, required

## Request body

- object
  - `pinned` boolean, required: true to pin the response, false to unpin

## Response `200`

Default Response

- object
  - `success` boolean
  - `data` object
    - `id` string: Response GUID
    - `pinned` boolean: Pin state after update

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)