---
title: "Answer User Input"
method: POST
path: "/api/comms/{team_key}/user-input/{request_key}/answer"
tags: ["comms"]
---

# Answer User Input

`POST /api/comms/{team_key}/user-input/{request_key}/answer`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/comms/{team_key}/user-input/{request_key}/answer`
- Auth: HTTP bearer

## Path parameters

- `team_key` string, required
- `request_key` string, required

## Request body

- UserInputSubmission
  - `questionId` string, required
  - `action` 'answer' | 'skip'
  - `selectedOptionIds` string[]
  - `text` string, nullable

## Response `200`

Successful Response

- UserInputSnapshot
  - `key` string, required
  - `chatKey` string, required
  - `toolCallId` string, required
  - `status` 'pending' | 'answered' | 'skipped' | 'superseded', required
  - `question` UserInputQuestion, required
    - `id` string, required
    - `question` string, required
    - `selection` 'single' | 'multiple'
    - `options` UserInputOption[], required
      - `id` string, required
      - `label` string, required
      - `description` string, nullable
    - `allowFreeText` boolean
    - `required` boolean
  - `answer` UserInputSubmission
    - `questionId` string, required
    - `action` 'answer' | 'skip'
    - `selectedOptionIds` string[]
    - `text` string, nullable
  - `respondentMembershipKey` string, nullable
  - `respondedAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)