---
title: "Submit Feedback"
method: POST
path: "/api/v1/feedback"
tags: ["feedback"]
---

# Submit Feedback

`POST /api/v1/feedback`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/v1/feedback`
- Auth: HTTP bearer

Records one feedback report for the calling account and emails the founders.

Returns 202 with the stored report. 404 when `agentId` is not the caller's
agent, 429 past the per-minute or 24-hour cap.

## Request body

- FeedbackCreate
  - `message` string, required: What went wrong, in plain words. Include what you expected.
  - `kind` string: What the report is about: one of ['api', 'cli', 'computers', 'dashboard', 'docs', 'other', 'sdk'].
  - `subject` string, nullable: The page URL, endpoint, SDK method or CLI command the report concerns.
  - `agentId` string, nullable: The Maritime agent the report is about, when there is one.
  - `requestId` string, nullable: The X-Request-Id of the failing call, when the report is about one.
  - `statusCode` integer, nullable: HTTP status of the failing call, when the report is about one.
  - `tool` string, nullable: Who is sending, e.g. "claude-code/2.1.0" or "codex".
  - `context` object, nullable: Up to 20 flat key/value pairs (SDK version, OS, ...). Never put secrets or env values here.

## Response `202`

Successful Response

- FeedbackResponse
  - `id` string, required
  - `kind` string, required
  - `subject` string, nullable, required
  - `message` string, required
  - `agentId` string, nullable, required
  - `requestId` string, nullable, required
  - `statusCode` integer, nullable, required
  - `tool` string, nullable, required
  - `createdAt` string, date-time, required

## Other responses

- `422`: Validation Error

---

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