# Organization

> Read the organization the current credential is scoped to — name, plan, chat platform, timezone, and feature flags.

Language: en
Canonical: https://www.dailybot.com/developers/api/organization
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-07-09

---

## 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. |

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

**Response (200 OK):**

```json
{
  "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](/developers/api/organization).

## Endpoints in this group

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.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/v1/organization/` | Current organization |

### GET `/v1/organization/`

**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.

- **Auth:** API key (`X-API-KEY`), CLI Bearer (read)
- **Rate limit:** `default`
- **Pagination:** No pagination

#### Response body

```json
{
  "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

| 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. |

#### Example (curl)

```bash
curl -sS -X GET 'https://api.dailybot.com/v1/organization/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'
```

#### Notes

- 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.

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization) (this page)
- [Teams](/developers/api/teams)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Report channels](/developers/api/report-channels)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)