permission_error

What the error looks like

{
  "type": "error",
  "error": {
    "type": "permission_error",
    "message": "Your API key does not have permission to use the specified resource."
  }
}

Common causes

• Using a model not available on your current plan (e.g., claude-opus-4-7 on free tier)
• Accessing a feature in early access / beta that requires allowlisting
• Workspace-level model restrictions set by an admin
• Using a model ID string that requires a higher tier (check exact model name)
• Key belongs to a sub-workspace without full permissions

Model availability by tier

Fix: Check which models you can access

import anthropic

client = anthropic.Anthropic()

# Use a model that's available on your plan
# Start with claude-haiku if access is uncertain:
try:
    response = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=10,
        messages=[{"role": "user", "content": "hi"}]
    )
    print("Sonnet: accessible")
except anthropic.PermissionDeniedError:
    print("Sonnet: not on your plan")
    # Fallback to haiku
    response = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=10,
        messages=[{"role": "user", "content": "hi"}]
    )

FAQ