Approval errors

When a call to the approvals binding is refused, you get an error with a code you can test for. The body looks like this:

{
  "error": {
    "code": "approval_rate_limited",
    "message": "…",
    "how_to_fix": "…"
  }
}

message says what happened. how_to_fix says what to do. In the SDK the call throws a PlatformError with .status, .code, .message, .howToFix and .requestId.

import { PlatformError } from '@cohostly/sdk'

try {
  const approval = await platform.approvals.request({ summary: 'Delete 12 rows from orders' })
} catch (e) {
  if (e instanceof PlatformError && e.code === 'approval_rate_limited') return res.status(429).send('Too many asks. Try again in a minute.')
  throw e
}

from platform_gen import platform, PlatformError

try:
    approval = platform.approvals.request({"summary": "Delete 12 rows from orders"})
except PlatformError as e:
    if e.code == "approval_rate_limited":
        return {"error": "Too many asks. Try again in a minute."}
    raise

Errors from the binding

Errors that only the SDK makes

These come from your own process, not from the platform. They have no HTTP status.

What your callback route can answer

When the platform calls your callback_path, the SDK handler answers with these. The platform retries every answer that is not a 2xx. See callbacks and waiting.

Refusals people see

When a person answers in the dashboard or the CLI, a refusal uses one of these words. They are not codes your app receives.