Errors

Make runtime failures obvious to humans and agents.

Bilinc errors should tell an operator whether the problem is auth, entitlement, quota, rate, or runtime availability.

Install pathPyPI package
RuntimeHosted Cloud
InterfacePython + CLI + MCP
Releasev2.1.4
Error map

Do not treat every failure as a bad API key.

401 invalid_api_key

The bearer key is missing, revoked, malformed, or from the wrong workspace.

Next: Create a new key and run bilinc login again.

402 payment_required

Hosted runtime access needs an active paid entitlement after trial expiration.

Next: Open Account Billing or contact support.

403 entitlement_missing

The key exists, but the workspace does not have the entitlement needed for the operation.

Next: Check plan, role, trial status, and entitlement sync.

429 rate_limited

The workspace is exceeding current throughput limits.

Next: Back off, batch work, or request Scale review.

5xx runtime_unavailable

The hosted runtime or dependency is unhealthy.

Next: Check /status and retry after service recovers.

Support payload
workspace: <workspace-id>
api_key_prefix: bil_live_****
status: 401 | 402 | 403 | 429 | 5xx
endpoint: /api/cloud/memory/commit
timestamp: 2026-07-05T00:00:00Z
reproduction: bilinc quicktest failed after login