parley
DocsPlatform
Resources
JournalIdeas on running AI supportCustomer storiesHow teams use ParleyGuidesStep-by-step playbooksChangelogWhat shipped, by versionHelp centerAnswers and support
CustomersPricing
LoginGet started
DocsPlatformCustomersPricingJournalCustomer storiesGuidesChangelogHelp center
Get startedLogin

Take charge of your AI customer experience

Get startedTalk to sales

Platform

Platform overviewChannelsPlaybooksIntegrationsAnalyticsPricing

Resources

DocumentationGuidesCustomer storiesJournalChangelogHelp center

Company

AboutCareersContact salesContact supportTerms of servicePrivacy

Security

Trust centerSOC 2ISO 27001GDPRHIPAAData processing
parley

© Parley. All rights reserved.

Docs home

Get started

Quickstart

Build your agent

PlaybooksChannelsKnowledgeActions

Developers

Parley CLICustom codeAPI keysWebhooks

Test and ship

TracesSplit testingSimulations
All docs
Docs home

Get started

Quickstart

Build your agent

PlaybooksChannelsKnowledgeActions

Developers

Parley CLICustom codeAPI keysWebhooks

Test and ship

TracesSplit testingSimulations
Docs/Developers

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.

PreviousCustom codeNextWebhooks

Something unclear?Contact supportor browse thehelp centerAll guides

On this page

Creating a keyScopesUsing a keyRotation