Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
SDK failures and safe recovery.
MudraIDError. Token acquisition failures are SDK
exceptions; responses from the protected resource remain requests.Response
objects for your application to handle.
| Exception | Meaning and handling |
|---|---|
MudraIDConfigError | Missing/invalid configuration; correct the selected prefix, endpoint or signing-key setup. |
MudraIDAuthError | Token-endpoint authentication refusal; check client/key status and assertion audience. |
MudraIDRevokedError | Authority refused; review the grant, resource, scopes and agent/client state before retrying. |
MudraIDNetworkError | Transport failure or malformed token response; investigate and use bounded recovery where safe. |
MudraIDRateLimitedError | Rate limit; respect retry_after_seconds when supplied. Subclass of MudraIDNetworkError. |
MudraIDBillingFrozenError | Billing/plan refusal; review the server’s reason. Waiting alone may not help. Subclass of MudraIDNetworkError. |
MudraIDScopeError | Invalid/unbounded scope request, rejected locally. Name the specific required scopes. |
MudraIDExecutionUnknownError | A consequential operation has an uncertain outcome. Reconcile before replaying. |
MudraIDNetworkError
handler. Do not infer that credentials were verified from an error status alone;
an edge or earlier server check may have produced it.
from mudraid import MachineAgent, MudraIDError
agent = MachineAgent.from_env()
try:
response = agent.get("https://your-platform.example/tasks", timeout=15)
response.raise_for_status()
except MudraIDError as exc:
# Apply application-specific recovery; avoid recording credentials or bodies.
raise
finally:
agent.close()