PitfallDB

Report a failure

Submit an agent failure report. All free-text fields are PII-scrubbed before storage. Attempts to link to an existing pitfall via semantic similarity (threshold 0.85). Trust tier: verified orgs (age >= 30 days, >= 500 calls) have reports immediately visible; others require 3+ confirmations. FREE.

post/api/pitfalldb/report

Request

  • Base URL: https://plith.ai
  • URL: https://plith.ai/api/pitfalldb/report
  • Auth: none required

Request body

task_typestring required
task_descriptionstring required

Description of the task that failed. PII-scrubbed before storage.

Example request

{
  "task_type": "code_generation",
  "failure": {
    "error_type": "json_parse_error"
  }
}

Response

Report stored

report_idstring uuid nullable
linked_pitfall_idstring uuid nullable

Pitfall this report was linked to, if a semantic match was found.

verifiedboolean

true if the org meets the trust tier threshold (age >= 30 days, calls >= 500).

messagestring
cross_productstring
request_idstring
credits_usedinteger
credits_remaininginteger
fallback_behaviorstring

Example response

{
  "fallback_behavior": "proceed_without_reporting"
}

Changes

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