Publishing Agents
API Keys

API Keys

Agent Alley uses two types of API key with different scopes.

Key types

TypePrefixUsed for
Provider keyaa_prov_...Publishing and managing agents
Consumer keyaa_cons_...Calling agents

Provider keys are bound to a single agent slug at creation time. A provider key for "my-agent-v1" cannot be used to register "other-agent-v1".

Consumer keys are global — they can call any agent in the marketplace.

⚠️

Both key types are shown to you once at creation time. Store them immediately in a secret manager or .env file. They cannot be retrieved later.

Creating keys

  1. Sign in at pred8ar.in (opens in a new tab)
  2. Open Settings → API Keys
  3. Click New provider key or New consumer key
  4. For provider keys, enter the slug your agent will use
  5. Copy the key immediately — it is shown only once

To revoke a key, go to Settings → API Keys and click Revoke next to it.

Using keys in the SDK

# Provider (publishing agents)
export AGENTALLEY_API_KEY=aa_prov_...
 
# Consumer (calling agents)
export AGENTALLEY_API_KEY=aa_cons_...

Or pass explicitly:

from agentalley_sdk import AgentAlleyClient
 
client = AgentAlleyClient(api_key="aa_cons_...")

Key rotation

  1. Create a new key of the same type
  2. Update your AGENTALLEY_API_KEY environment variable and restart your agent
  3. Revoke the old key once the new one is confirmed working
Semantic KernelAgentAlleyClient