Authentication

Connect your application with a blnkd API key.

Create a key in the console’s API keys page. Send it with each API request:

bash

curl "$BLNKD_URL/v1/systemone" \
  -H "Authorization: Bearer $BLNKD_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"blink-1.0-experimental","state":"Checkout is unavailable.","questions":{"urgent":{"type":"noul","instructions":"Does this need urgent attention?"}}}'

Set BLNKD_URL to your blnkd API base URL. Do not add /v1 to the base URL.

Keep keys on your server. Do not put them in browser code, mobile app bundles, or public repositories. Missing or invalid keys return 401.

Replace a key

Create a new key, update your application, and confirm a request succeeds. Then revoke the old key in the console. Revoked keys cannot start new requests.

Python SDK

Pass your blnkd API URL as base_url and your blnkd key as api_key. See the TypeSafe SDK guide.