tinyhumansai/openhuman · error

Backend returned {status_text} for {method_upper} {url}: {de

Error message

Backend returned {status_text} for {method_upper} {url}: {detail}

What it means

map_sdk_error's generic status arm: the backend answered with a non-success HTTP status that is not a transport error or a 401. The status text, method, URL and body detail are formatted into the error and reported to observability for triage.

Source

Thrown at src/openhuman/integrations/client.rs:468

                        &detail
                    ));
                }
                let status_text = reqwest::StatusCode::from_u16(status)
                    .map(|status| status.to_string())
                    .unwrap_or_else(|_| status.to_string());
                let status_code = status.to_string();
                crate::core::observability::report_error_or_expected(
                    format!("Backend returned {status_text} for {method_upper} {url}: {detail}")
                        .as_str(),
                    "integrations",
                    method,
                    &[
                        ("path", path),
                        ("status", status_code.as_str()),
                        ("failure", "non_2xx"),
                    ],
                );
                anyhow::anyhow!("Backend returned {status_text} for {method_upper} {url}: {detail}")
            }
            other => anyhow::anyhow!("{method_upper} {url} failed: {other}"),
        }
    }

    fn parse_envelope<T: serde::de::DeserializeOwned>(
        method: &str,
        path: &str,
        url: &str,
        value: serde_json::Value,
    ) -> anyhow::Result<T> {
        let method_upper = method.to_uppercase();
        let envelope: BackendResponse<T> = serde_json::from_value(value)?;
        if !envelope.success {
            let msg = envelope
                .error
                .unwrap_or_else(|| "unknown backend error".into());
            crate::core::observability::report_error_or_expected(

View on GitHub (pinned to 7491200858)

Solutions

1. Check the status code and body detail for the specific backend refusal (validation, quota, server error)
2. Retry on 5xx — server-side failures are often transient
3. Verify request parameters if the status is 4xx

When it happens

Trigger: Thrown at src/openhuman/integrations/client.rs:468 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of tinyhumansai/openhuman@7491200858 (2026-08-17). Data as JSON: /api/errors/ac74d2798bf09c4b. Report an issue: GitHub.