tinyhumansai/openhuman · error

Missing 'app' or 'auth_config_id' for v3 connect

Error message

Missing 'app' or 'auth_config_id' for v3 connect

What it means

Input validation in get_connection_url_v3: building a Composio v3 connection link requires an `auth_config_id`, and when it is absent the caller must at least supply `app` so the auth config can be resolved. Thrown when both `app_name` and `auth_config_id` are None (or auth_config_id lookup falls through with no app name), meaning the v3 connect path cannot identify which integration to connect.

Source

Thrown at src/openhuman/integrations/composio/tools/direct.rs:548

                    Err(v2_err) => anyhow::bail!(
                        "Composio connect failed on v3 ({v3_err}) and v2 fallback ({v2_err})"
                    ),
                }
            }
        }
    }

    async fn get_connection_url_v3(
        &self,
        app_name: Option<&str>,
        auth_config_id: Option<&str>,
        entity_id: &str,
    ) -> anyhow::Result<String> {
        let auth_config_id = match auth_config_id {
            Some(id) => id.to_string(),
            None => {
                let app = app_name.ok_or_else(|| {
                    anyhow::anyhow!("Missing 'app' or 'auth_config_id' for v3 connect")
                })?;
                self.resolve_auth_config_id(app).await?
            }
        };

        let url = format!("{}/connected_accounts/link", self.base_v3);
        let body = json!({
            "auth_config_id": auth_config_id,
            "user_id": entity_id,
        });

        let resp = self
            .client()
            .post(&url)
            .header("x-api-key", &self.api_key)
            .json(&body)
            .send()
            .await?;

View on GitHub (pinned to 7491200858)

Solutions

1. Pass app_name (the Composio app/toolkit slug) or auth_config_id
2. Pass both when the app has multiple auth configs

When it happens

Trigger: Thrown at src/openhuman/integrations/composio/tools/direct.rs:548 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/b2b231e155e7fd6d. Report an issue: GitHub.