---
title: "Create Submission"
method: POST
path: "/v1/feedback-program/submissions"
tags: ["feedback-program"]
---

# Create Submission

`POST /v1/feedback-program/submissions`

Submit feedback plus a session-context snapshot. Open to every
authenticated user; only an explicitly removed account is blocked.

## Request body

- SubmissionCreate
  - `body` string, required
  - `category` string, nullable
  - `route` string, nullable
  - `page_url` string, nullable
  - `page_load_id` string, nullable
  - `posthog_session_url` string, nullable
  - `posthog_distinct_id` string, nullable
  - `user_agent` string, nullable
  - `screen_size` string, nullable
  - `context_log` object[], nullable
  - `screenshot_urls` string[], nullable

## Response `201`

Successful Response

- SubmissionOut
  - `id` string, uuid, required
  - `user_id` string, nullable, required
  - `user_email` string, nullable, required
  - `user_name` string, nullable, required
  - `body` string, nullable, required
  - `category` string, nullable, required
  - `route` string, nullable, required
  - `status` 'new' | 'triaged' | 'resolved' | 'archived', required
  - `mode` 'text' | 'interview_turn' | 'voice', required
  - `context_log_count` integer, required
  - `created_at` string, date-time, required
  - `interview_conversation_id` string, uuid, nullable
  - `turn_index` integer, nullable
  - `reaction` 'up' | 'down', nullable
  - `github_issue_url` string, nullable
  - `github_issue_number` integer, nullable
  - `linear_issue_url` string, nullable
  - `linear_issue_identifier` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)