---
title: "Submit answers to a public Scope Refinement survey"
method: POST
path: "/surveys/{code}/responses"
tags: ["Surveys"]
---

# Submit answers to a public Scope Refinement survey

`POST /surveys/{code}/responses`

## Request

- Base URL: `https://api.apphandoff.com/api`
- URL: `https://api.apphandoff.com/api/surveys/{code}/responses`
- Auth: none required

Public: saves the response and sends best-effort notification emails to the survey owner and the respondent. Every survey question must get exactly one answer with a valid option key. IP rate limited.

## Path parameters

- `code` string, required

## Request body

- object
  - `respondent_email` string, email, required
  - `answers` ScopeSurveyAnswer[], required
    - `question_id` string, required
    - `choice` string, required: Option key of the chosen option.
    - `note` string
  - `comment` string

## Response `200`

Response saved

- object
  - `ok` true, required

## Other responses

- `400`: Invalid request
- `404`: Not found
- `429`: Rate limited

---

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