Users

Create, read, update, and soft-delete users, with a recycle bin (restore/purge), set-password, and verification.

The Users API manages user identities. Authenticate server-side with an API key (Authorization: ApiKey qk_…).

Create a user

POST/v1/usersCreate a user

curl

Bash

curl -X POST https://api.qeetid.com/v1/users \
  -H "Authorization: ApiKey $QEETID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "alex@acme.com", "display_name": "Alex Chen" }'

Email is globally unique; a duplicate returns 409.

Get a user

GET/v1/users/{id}Get a user

List users

GET/v1/usersList users (cursor paginated)

Bash

curl 'https://api.qeetid.com/v1/users?limit=50' \
  -H "Authorization: ApiKey $QEETID_API_KEY"
# → { "items": [ … ], "next_cursor": "…" }

See Pagination for the cursor loop.

Update a user

PATCH/v1/users/{id}Update a user

Set a password

PUT/v1/users/{id}/passwordSet a user's password

Verification

POST/v1/users/{id}/verify/email/startSend email OTP

POST/v1/users/{id}/verify/email/confirmConfirm email OTP

POST/v1/users/{id}/verify/phone/startSend SMS OTP

POST/v1/users/{id}/verify/phone/confirmConfirm phone OTP

Soft-delete & recycle bin

Deleting a user is a soft-delete — the user is disabled and lands in a recycle bin you can list, then either restore or purge (irreversible).

DELETE/v1/users/{id}Soft-delete a user

GET/v1/users/deletedList soft-deleted users

POST/v1/users/{id}/restoreRestore a user

POST/v1/users/{id}/purgePermanently purge a user

Purge is irreversible

Purge (and GDPR erasure) permanently removes personal data. The audit record of the deletion survives with PII redacted.

Linked identities

A user's social/SAML/LDAP logins attach as external identities.

GET/v1/users/{userID}/social/identitiesList linked identities

On this page