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.
On this page
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
| Status | When |
|---|---|
| 401 | Missing, invalid, or expired credential. |
| 403 | API key's organization is on a free plan. |
| 403 | Organization plan does not include API access. |
| 429 | Throttled — 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.