Organizations

An organization is the top-level billing and access-control entity in Crowdee. All credits, modules, and team members are managed at the organization level. Projects live inside organizations.

Creating an Organization

After signing up, you can create an organization from the dashboard. To create one via the API:

curl -X POST https://api.crowdee.ai/v2/organizations \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Media Verification",
    "description": "Verification workflows for the Acme newsroom"
  }'

Balance & Credits

Crowdee uses a pre-paid credit model. Credits are stored as balance_cents on the organization and deducted when pipeline runs complete. A balance of 0 blocks new verification runs from starting.

Example organization object:

{
  "id": "org_abc123",
  "name": "Acme Media Verification",
  "balance_cents": 4250,
  "modules": ["content_verification"],
  "createdAt": "2024-10-01T09:00:00Z"
}

balance_cents is an integer representing euro cents — 4250 equals €42.50. Check the current balance at any time:

curl https://api.crowdee.ai/v2/organizations/{orgId} \
  -H "X-API-Key: crw_YOUR_API_KEY"

Top-up via PayPal in the dashboard at Settings → Billing → Add Credits, or contact sales@crowdee.ai for invoiced top-ups on Managed and Enterprise plans.

Modules

Modules unlock feature sets within an organization. They are enabled by the Crowdee team during account activation.

Member Roles

Organization admins can invite members and assign roles. Roles control what each member can do within the organization and its projects — see the Role Permissions table for a full breakdown.

Invite a member via the API:

curl -X POST https://api.crowdee.ai/v2/organizations/{orgId}/invite \
  -H "X-API-Key: crw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "colleague@example.com", "role": "user"}'

Valid roles: viewer, user, admin. Only superadmins can assign the superadmin role.

Multiple Organizations

A single user account can belong to multiple organizations. Use a default organization for convenience, or switch context per-request using an org-scoped API key.

Set a default organization:

curl -X PUT https://api.crowdee.ai/v2/users/me/organizations/{orgId}/default \
  -H "X-API-Key: crw_YOUR_API_KEY"

API keys can be scoped to a specific organization at creation time. A scoped key only operates within that organization — requests to resources belonging to other organizations will be rejected, even if the user is a member of both.