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

# Submit Feedback

`POST /v1/feedback`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/feedback`
- Auth: HTTP bearer

Submit feedback, report a bug, or request a feature.

Use this endpoint to tell the AgentLine team about anything you
encounter while using the platform: something broken, a missing
capability, something hard to use, or general comments.

Your feedback is reviewed by the team. Include as much detail as
possible — for bugs, describe what you expected vs. what happened
and any steps to reproduce it.

Returns the saved feedback with its id (fb_...) and status "open";
check its progress later with list_feedback.

## Request body

- FeedbackCreate
  - `category` 'bug' | 'feature_request' | 'difficulty' | 'feedback', required
  - `message` string, required: Detailed description of the feedback, issue, or request. For bugs, include what you expected vs. what actually happened.
  - `subject` string, nullable: Short summary shown as the title, e.g. 'Outbound call drops after greeting'. When omitted the feedback is saved without a subject.
  - `severity` 'low' | 'normal' | 'high' | 'critical'
  - `agent_id` string, nullable: Agent the feedback is about (agt_... from list_agents), if any. Must be an agent on this account.
  - `contact_email` string, nullable: Email address for follow-up about this feedback (optional)

## Response `200`

Successful Response

- FeedbackOut
  - `id` string, required: Unique feedback identifier (e.g. 'fb_abc123')
  - `account_id` string, required: Account that submitted this feedback
  - `category` string, required: Feedback type: 'bug', 'feature_request', 'difficulty', or 'feedback'
  - `message` string, required: Full feedback message
  - `subject` string, nullable: Short summary title
  - `severity` string, required: Impact level: 'low', 'normal', 'high', or 'critical'
  - `agent_id` string, nullable: Related AI agent ID, if any
  - `contact_email` string, nullable: Follow-up email, if provided
  - `status` string, required: Current status: 'open', 'acknowledged', 'in_progress', 'resolved', or 'closed'
  - `created_at` string, date-time, required: When the feedback was submitted

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)