Skip to content
view raw .md

Organization

Read the organization the current credential belongs to. Every API call is scoped to this organization; use this endpoint to confirm the org context before running batch operations.

GET/v1/organization/API keyCLI Auth

Current organization

Retrieves the organization that the current credential (API key or CLI Bearer token) belongs to. Use this to confirm scope, inspect plan details, and verify connectivity before running batch jobs or switching environments.

Response

{
  "uuid": "ba2371a9-81c7-4132-b9c4-a338561ec3a0",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "plan": "growth",
  "chat_platform": "slack",
  "timezone": "America/New_York",
  "language": "en",
  "daily_reports_enabled": true,
  "kudos_enabled": true,
  "mood_enabled": false,
  "created_at": "2021-06-15T08:30:00Z"
}

Errors

StatusWhen
401Missing, invalid, or expired credential.
403API key's organization is on a free plan.
403Organization plan does not include API access.
429Throttled — Retry-After header set.
curl -sS -X GET 'https://api.dailybot.com/v1/organization/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'

Try it

This is a copy-only helper — the request is not sent from your browser. Paste the command into your terminal to execute it.

  • Every API call is scoped to a single organization — the one the credential belongs to. There is no way to query multiple organizations in a single call.

Organization

Every Dailybot API call is scoped to a single organization — the one the current credential (X-API-KEY or CLI Bearer token) belongs to. Use this endpoint to confirm scope, inspect plan details, and verify connectivity before running batch jobs or switching environments.

GET /v1/organization/

Returns the organization object for the current credential.

Auth: API key (X-API-KEY) or CLI Bearer token.

Response fields

Field Type Description
uuid string Organization UUID.
name string Display name of the organization.
slug string URL-safe identifier.
plan string Current plan name (e.g. growth, enterprise).
chat_platform string Connected chat platform (slack, teams, discord, google_chat).
timezone string Organization default timezone (IANA format).
language string Default language code (en, es, pt).
daily_reports_enabled boolean Whether daily reports are active.
kudos_enabled boolean Whether kudos feature is enabled.
mood_enabled boolean Whether mood tracking is enabled.
created_at string (ISO 8601) When the organization was created.
curl -sS "https://api.dailybot.com/v1/organization/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Response (200 OK):

{
  "uuid": "ba2371a9-81c7-4132-b9c4-a338561ec3a0",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "plan": "growth",
  "chat_platform": "slack",
  "timezone": "America/New_York",
  "language": "en",
  "daily_reports_enabled": true,
  "kudos_enabled": true,
  "mood_enabled": false,
  "created_at": "2021-06-15T08:30:00Z"
}

Error codes

HTTP code When
401 invalid_credentials Missing, invalid, or expired credential.
403 plan_free_api_keys_forbidden API key’s organization is on a free plan.
403 plan_missing_core_api_integrations Organization plan does not include API access.
429 Throttled — respect Retry-After header.

See the full interactive reference at /developers/api/organization.