Users & Organization

Manage users, get context info (/me), retrieve organization details, update profiles and metadata, and invite members.

Endpoints summary

Personalization

Private per-user dashboard state under /v1/me/.... Not gated by Labels entitlement — any authenticated member can use preferences, saved views, and Featured.

Empty preference: GET /v1/me/dashboard-preferences/{surface}/ with no saved state returns 200:

{"surface": "forms_home", "schema_version": 1, "filters": {}, "updated_at": null}

DELETE on dashboard preferences is idempotent (204). Writes accept canonical filters; legacy payload is still accepted (filters wins when both are sent).

When Labels are unavailable, preference payloads may retain Label filters at rest but responses omit them with warning labels_feature_unavailable.

Featured is private per user — is_featured on forms/check-ins/automations list endpoints reflects only the caller, never teammates.

GET /v1/me/

Returns information about the authenticated user and their organization.

curl -X GET "https://api.dailybot.com/v1/me/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "id": "usr_abc123",
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Doe",
  "role": "admin",
  "timezone": "America/New_York",
  "organization": {
    "id": "org_xyz789",
    "name": "Acme Corp",
    "plan": "pro"
  }
}

GET /v1/organization/

Returns the organization details for the authenticated API key.

curl -X GET "https://api.dailybot.com/v1/organization/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "id": "org_xyz789",
  "name": "Acme Corp",
  "plan": "pro",
  "member_count": 45,
  "created_at": "2023-01-15T00:00:00Z"
}

GET /v1/users/

Returns all users in the organization. Paginated (default ordering: full_name).

Query parameters

curl "https://api.dailybot.com/v1/users/?is_active=true&search=alice&page_size=50" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "usr_abc123",
      "email": "[email protected]",
      "first_name": "Alice",
      "last_name": "Smith",
      "role": "member",
      "is_active": true,
      "timezone": "America/New_York"
    }
  ]
}

Iterating all users

PAGE=1
while true; do
  RESP=$(curl -s "https://api.dailybot.com/v1/users/?is_active=true&page=$PAGE&page_size=100" \
    -H "X-API-KEY: $DAILYBOT_API_KEY")
  echo "$RESP" | jq '.results[]'
  NEXT=$(echo "$RESP" | jq -r '.next')
  [ "$NEXT" = "null" ] && break
  PAGE=$((PAGE + 1))
done

GET /v1/users/{uuid}/

Returns a specific user.

curl -X GET "https://api.dailybot.com/v1/users/usr_abc123/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

PATCH /v1/users/{uuid}/

Updates a user’s profile or metadata. Only Org Administrators can update other users.

Body parameters

curl -X PATCH "https://api.dailybot.com/v1/users/usr_abc123/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "Europe/London",
    "metadata": { "department": "Engineering", "location": "London" }
  }'

Response (200 OK):

{
  "uuid": "usr_abc123",
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Doe",
  "timezone": "Europe/London",
  "metadata": { "department": "Engineering", "location": "London" }
}