Users & Organization API - DailyBot Developers

DailyBot API endpoints for managing users, inviting members, and retrieving organization information.

Users & Organization

Manage organization members, retrieve user profiles, invite new users, and access organization metadata. The /me/ endpoint returns context about the authenticated API key owner.

Get Context Info

GET /v1/me/

Retrieves contextual information about the authenticated user and their organization.

Request 
curl -X GET "https://api.dailybot.com/v1/me/" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "email": "admin@company.com",
  "full_name": "Jane Smith",
  "role": "admin",
  "timezone": "America/New_York",
  "organization": {
    "uuid": "org-1234-5678-abcd",
    "name": "Acme Corp",
    "platform": "slack"
  }
}

Get Organization

GET /v1/organization/

Retrieves organizational metadata and configuration.

Request 
curl -X GET "https://api.dailybot.com/v1/organization/" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
{
  "uuid": "org-1234-5678-abcd",
  "name": "Acme Corp",
  "platform": "slack",
  "external_id": "T01234567",
  "supported_domains": [
    "company.com"
  ],
  "auth_settings": {
    "sso_enabled": false
  }
}

List Users

GET /v1/users/

Fetches information about all organization members. Returns a paginated list of user profiles.

Request 
curl -X GET "https://api.dailybot.com/v1/users/" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
{
  "count": 25,
  "next": "https://api.dailybot.com/v1/users/?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "full_name": "Jane Smith",
      "email": "jane@company.com",
      "role": "admin",
      "timezone": "America/New_York",
      "active": true,
      "bot_enabled": true,
      "work_days": [
        0,
        1,
        2,
        3,
        4
      ]
    }
  ]
}

Get User

GET /v1/users/{user-uuid}/

Retrieves data for a specific user by UUID.

Request 
curl -X GET "https://api.dailybot.com/v1/users/a1b2c3d4-e5f6-7890-abcd-ef1234567890/" \
  -H "X-API-KEY: your_api_key"
Response 200 OK
json 
{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "full_name": "Jane Smith",
  "email": "jane@company.com",
  "role": "admin",
  "timezone": "America/New_York",
  "active": true,
  "bot_enabled": true,
  "occupation": "Engineering Manager",
  "work_days": [
    0,
    1,
    2,
    3,
    4
  ],
  "work_start_time": "09:00"
}

Update User

PATCH /v1/users/{user-uuid}/

Updates user profile information. Only provided fields are modified.

Body Parameters

Name Type Required Description
full_name string Optional Full name of the user.
occupation string Optional Job title or occupation.
birth_date string Optional Birth date in YYYY-MM-DD format.
active boolean Optional Whether the user is active.
bot_enabled boolean Optional Whether DailyBot is enabled for this user.
timezone string Optional IANA timezone (e.g. America/New_York).
work_days array Optional Array of working days (0=Monday, 6=Sunday).
timeoff_dates array Optional Array of time-off dates in YYYY-MM-DD format.
work_start_time string Optional Work start time in HH:MM format.
Request 
curl -X PATCH "https://api.dailybot.com/v1/users/a1b2c3d4-e5f6-7890-abcd-ef1234567890/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Chicago",
    "work_days": [0, 1, 2, 3, 4],
    "work_start_time": "08:00"
  }'
Response 204 No Content
json

Invite User

POST /v1/invite-user/

Invites users to the organization via email addresses or external platform IDs.

Body Parameters

Name Type Required Description
users_identifiers array Required Array of email addresses or external platform IDs to invite (max 100).
Request 
curl -X POST "https://api.dailybot.com/v1/invite-user/" \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "users_identifiers": ["new@company.com", "another@company.com"]
  }'
Response 200 OK
json 
{
  "invited": [
    "new@company.com"
  ],
  "already_members": [
    "another@company.com"
  ],
  "invalid": []
}

Info

The API key must belong to an Organization Administrator to invite users. Non-admin keys will receive a 403 Forbidden response.