All docs
API keys
API keys authenticate the CLI in CI and calls to the Parley REST API. Each key belongs to one workspace and carries only the scopes you give it.
Creating a key
Go to Settings → API keys and choose New key. Name it after where it will live, pick its scopes and an expiry. The key is shown once; store it in your secret manager.
Scopes
read: projects, playbooks, conversations and traces.write: edit playbooks, knowledge and actions in test environments.deploy: promote environments and start or stop split tests.admin: manage members, keys and billing. Avoid it in CI.
Using a key
bash
export PARLEY_TOKEN=pk_live_…
curl https://api.parley.ai/v1/projects \
-H "Authorization: Bearer $PARLEY_TOKEN"Rotation
Keys can be rotated with a grace period, so the old key keeps working for up to 24 hours while you roll out the new one. Every use is recorded in the audit log.
Something unclear?Contact supportor browse thehelp centerAll guides