Record product feedback

POST/feedback

Records product feedback from the authenticated user. Use kind=missing_capability for blocked public API workflows such as unsupported upload-asset source hosts, and include attempted_tools when relevant. Feedback can be optionally linked to a workspace, project, or run. Mutating public API requests support an optional Idempotency-Key header for client retries; duplicate keys within two hours return idempotency_duplicate.

Body ParametersJSONExpand Collapse

detail: string

Detailed description

minLength1

kind: "feature_request" or "bug" or "technique_request" or "missing_capability"

Feedback kind. Use missing_capability for blocked API workflows such as unsupported asset source hosts.

One of the following:

"feature_request"

"bug"

"technique_request"

"missing_capability"

summary: string

Short summary

minLength1

attempted_tools: optional array of string

Tools or capabilities attempted before submitting feedback

project_id: optional string

Project identifier. Use the public API ID returned by list projects; it must start with prj_.

run_id: optional string

Run identifier. It must start with run_.

workspace_id: optional string

Workspace identifier. Use the public API ID returned by list workspaces; it must start with ws_.

ReturnsExpand Collapse

feedback_id: string

Feedback identifier

received_at: number

Record product feedback

curl https://app.flora.ai/api/v1/feedback \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $FLORA_API_KEY" \
    -d '{
          "detail": "upload-asset rejected an image hosted on scontent-lga3-1.cdninstagram.com.",
          "kind": "missing_capability",
          "summary": "Need support for Instagram CDN asset URLs"
        }'

{
  "feedback_id": "fb_abc123",
  "received_at": 0
}

{
  "error": {
    "code": "input_validation_error",
    "message": "prompt: Required",
    "fields": [
      {
        "field": "prompt",
        "message": "Required"
      }
    ]
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key."
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Forbidden."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Not found."
  }
}

{
  "error": {
    "code": "idempotency_duplicate",
    "message": "Duplicate idempotency key."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}

{
  "error": {
    "code": "unknown_error",
    "message": "An unknown error occurred."
  }
}

Returns Examples

{
  "feedback_id": "fb_abc123",
  "received_at": 0
}

{
  "error": {
    "code": "input_validation_error",
    "message": "prompt: Required",
    "fields": [
      {
        "field": "prompt",
        "message": "Required"
      }
    ]
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key."
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "Insufficient credits."
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Forbidden."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Not found."
  }
}

{
  "error": {
    "code": "idempotency_duplicate",
    "message": "Duplicate idempotency key."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}

{
  "error": {
    "code": "unknown_error",
    "message": "An unknown error occurred."
  }
}