Feedback

Send product feedback to the Shardflux team

Delivered by email to the Shardflux team. Any valid project API key may send (no tool permission needed); the key's organization and project are recorded, so organization_id is rejected (422). A CLI session (sfu_) may send too, with an optional organization_id of the user's. Coding agents: send only when the user asks to report feedback, show the exact message and context first, obtain explicit authorization, and include context (agent, client, workspace, request_id and error_code of the error response, command). Rate limited per sender (10 per 10 minutes, 50 per day) and per organization (200 per day): 429 rate_limited with a retry-after header and details.retry_after_seconds. The same message from the same sender within 24 hours is a duplicate: 200 with the original id and duplicate: true (it still counts against the rate limits). The body is limited to 32 KiB (413).

post/v1/feedback

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/feedback
  • Auth: HTTP bearer

Request body

messagestring required

The feedback, 1-8000 characters after trimming surrounding whitespace (must contain a non-whitespace character). Control characters other than newline and tab are stripped; API keys, bearer tokens, JWTs, AWS access key ids and private key blocks are redacted before it is stored or emailed.

category'bug' | 'confusing' | 'missing' | 'idea' | 'praise' | 'other'

Default other. bug: something failed or behaved wrongly; confusing: an error, doc, name or output was unclear or misleading; missing: a capability, option or template you needed does not exist; idea: a suggestion or improvement; praise: something worked well; other: anything else.

organization_idstring uuid

Sessions (browser, or a CLI session on /v1): the organization the user is looking at, one they belong to (404 otherwise). Refused (422) with a project API key, whose organization is used.

Response

Default Response

idstring uuid required

UUIDv7, lowercase canonical form.

received_atstring date-time required

RFC 3339 UTC timestamp with Z.

duplicateboolean required

true when the same sender sent the same message within 24 hours: the original feedback is returned and nothing new is stored or emailed.

Changes

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