Operations

Submit product feedback to the public board

Create a product bug, idea, or feedback item on the same public board as the dashboard (/dashboard/feedback). Requires a bearer API key with posts:write and active API add-on access; browser-session fallback is rejected. Requires confirm: true after the user explicitly approves the title and category. Limited to 5 submissions per day per API key. Do not use this for tool failures (use /api/v1/agent-feedback for private telemetry). Never include API keys, secrets, captions, media URLs, or personal data about third parties. Inserts trigger the same Slack and Hermes triage paths as dashboard submissions.

post/api/v1/feedback

Request

Base URL: https://www.poster.ly
URL: https://www.poster.ly/api/v1/feedback
Auth: HTTP bearer

Request body

category'bug' | 'idea' | 'feedback' required

titlestring required

Short public title for the feedback board.

descriptionstring

Optional details. Never include API keys, secrets, captions, media URLs, or personal data about third parties.

clientstring

confirmtrue required

Must be true after the user explicitly approves filing this on the public board.

source'mcp' | 'cli' | 'rest' | 'skill'

Example request

{
  "category": "bug",
  "title": "LinkedIn carousel fails when third image is HEIC",
  "description": "When scheduling a 3-image carousel, HEIC on image 3 returns invalid_media without saying which file.",
  "client": "claude-desktop",
  "confirm": true,
  "source": "mcp",
  "context": {
    "request_id": "req_example123",
    "related_tool": "create_post"
  }
}

Response

Feedback filed on the public board

acceptedtrue required

feedback_idinteger required

board_urlstring uri required

request_idstring required

Example response

{
  "accepted": true,
  "feedback_id": 42,
  "board_url": "https://www.poster.ly/dashboard/feedback",
  "request_id": "req_example123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.