Organizations let you share CarsXE API access with your team. Invite members, assign roles, and manage organization-wide API keys from a single workspace.
Organizations are shared workspaces that let you collaborate with your team on CarsXE. Instead of every teammate managing their own account and API key, an organization gives you a single place to invite members, control what they can do with roles, and manage organization API keys that everyone can use.
You manage organizations from your dashboard. No separate API is required.
Billing is not organization-specific. Usage from organization API keys rolls up to the organization owner's personal subscription. There is no separate per-organization plan or invoice.
Every member of an organization has one of four roles. The owner is the user who created the organization and cannot be removed. All other members are assigned one of the remaining roles.
| Capability | Owner | Admin | Editor | Viewer |
|---|---|---|---|---|
| View team & API keys | Yes | Yes | Yes | Yes |
| Create API keys | Yes | Yes | Yes | No |
| Enable/disable & rename API keys | Yes | Yes | Yes | No |
| Delete API keys | Yes | Yes | No | No |
| Invite members | Yes | Yes | No | No |
| Update member roles & remove members | Yes | Yes | No | No |
| Invite, promote, or manage admins | Yes | No | No | No |
| Edit organization settings | Yes | No | No | No |
| Delete the organization | Yes | No | No | No |
Admins can manage editors and viewers, but only the owner can invite, promote, or manage other admins. The owner cannot be removed or have their role changed.
Owners and admins can invite teammates to the organization by email, one at a time or in bulk. Each invitation is sent with the role you choose for the invitee.
Organization API keys work exactly like personal API keys when calling the CarsXE API — you pass them as the key parameter on any endpoint. The difference is that an organization key belongs to the workspace, so any current member can use it and key management is shared across the team.
Use an organization API key the same way you use any CarsXE key:
curl https://api.carsxe.com/v1/auth/validate \
-d key=ORGANIZATION_API_KEYSee Authentication for more on how API keys authenticate your requests.
Organizations are a collaboration and access-management layer — they are not a billing entity. When a request is made with an organization API key, the usage resolves to the owner's account and counts against the owner's personal subscription.
This means:
Only the owner can delete an organization. Deleting an organization removes the team's access to its shared API keys. Be sure your team has migrated to other keys before deleting.
Ready to set up your team? Head to your dashboard to create an organization, invite members, and generate your first organization API key.