View Your Organization

Before you begin

• You have an API key (pai_test_* or pai_live_*)

Get your organization

Every API key is scoped to a single organization. Use this endpoint to verify which org your key belongs to:

$
curl https://api-staging.pyramid-ai.com/api/v2/organization \
>
  -H "Authorization: Bearer pai_test_YOUR_KEY_HERE"

1
{
2
  "success": true,
3
  "data": {
4
    "id": "org_abc123",
5
    "name": "Your Organization"
6
  },
7
  "request_id": "..."
8
}

When to use this

• Verify your key works — this is the quickest authenticated call to confirm your API key is valid and active
• Confirm org scope — if you manage multiple organizations, use this to check which org your current key is scoped to
• Debug authorization issues — if other endpoints return 403, check that your key’s org has the required features enabled

What’s next

• Create a Project — start building your knowledge base
• Authentication — learn about key rotation and environments