Authentication

API keys authenticate both SDK connections and direct API requests. Get yours from API Keys in the dashboard. Keys are scoped to your organization and start with plx_.

In the SDK

Pass the key directly, or set PLEXUS_API_KEY as an environment variable and the SDK picks it up automatically:

import os
from plexus import Plexus
 
# Explicit
px = Plexus(api_key=os.environ.get("PLEXUS_API_KEY"), source_id="robot-01")
 
# Or set the env var and omit api_key entirely
# export PLEXUS_API_KEY=plx_...
px = Plexus(source_id="robot-01")

In API requests

Pass the key in the x-api-key header on every request:

curl https://api.plexus.company/v1/sources \
  -H "x-api-key: plx_..."