← Back to help
HR Updated April 2026

HR data isn't loading

Quick check: if @Ceven what's our headcount? in Slack returns a number, you're already set up. This page is for the case where the bot says it can't access HR data.

What's happening

Ceven is migrating organization IDs from a legacy integer shape to UUID. Older accounts can still log in fine, but the HR database keys everything by UUID, so the chat bot can't query it for legacy-shaped accounts. The fix is a one-line database update.

How to fix it (admin)

  1. SSH into your Ceven backend or open the admin console.
  2. Run the migration script: 
    python -m app.scripts.migrate_org_to_uuid \
    --tenant-id-int=<your_int_tenant_id>
  3. The script writes a fresh UUID into users.uuid_id and organizations.id, then verifies HR queries succeed.
  4. Have the affected user log out + back in to refresh their JWT.

How to fix it (non-admin)

  1. Find your team's Ceven admin (whoever first set up the account).
  2. Send them the link to this page.
  3. Once they run the migration, log out of Ceven and back in.
Heads-up: the migration is non-destructive — your existing data, integrations, and login all keep working. It just adds the UUID column the new HR tables expect.

If the migration script fails

Email hello@ceven.io with your tenant ID — the team will run it manually within a few hours. We log the timestamp + diff so it's auditable.