Skip to content
ver .md sin procesar

Organización

Consulta la organización a la que pertenece la credencial actual. Cada llamada a la API está limitada a esta organización; usa este endpoint para confirmar el contexto de la org antes de correr operaciones batch.

GET/v1/organization/API keyCLI Auth

Organización actual

Obtiene la organización a la que pertenece la credencial actual (API key o token Bearer del CLI). Útil para confirmar el scope, inspeccionar detalles del plan y verificar la conectividad antes de ejecutar trabajos por lotes o cambiar de entorno.

Respuesta

{
  "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"
}

Errores

EstadoCuándo
401Credencial ausente, inválida o expirada.
403La organización de la API key está en un plan gratuito.
403El plan de la organización no incluye acceso a la API.
429Throttled — cabecera Retry-After establecida.
curl -sS -X GET 'https://api.dailybot.com/v1/organization/' \
  -H 'X-API-KEY: $DAILYBOT_API_KEY'

Probarlo

Este es un asistente de solo copia — la solicitud no se envía desde tu navegador. Pega el comando en tu terminal para ejecutarlo.

  • Cada llamada a la API está limitada a una sola organización — aquella a la que pertenece la credencial. No es posible consultar múltiples organizaciones en una sola llamada.

Organización

Cada llamada a la API de Dailybot está limitada a una sola organización — la de la credencial actual (X-API-KEY o token Bearer del CLI). Usa este endpoint para confirmar el scope, inspeccionar los detalles del plan y verificar la conectividad antes de ejecutar jobs en lote o cambiar de entorno.

GET /v1/organization/

Devuelve el objeto de organización para la credencial actual.

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

Campos de respuesta

Campo Tipo Descripción
uuid string UUID de la organización.
name string Nombre de la organización.
slug string Identificador URL-safe.
plan string Nombre del plan actual (ej. growth, enterprise).
chat_platform string Plataforma de chat conectada (slack, teams, discord, google_chat).
timezone string Zona horaria predeterminada de la organización (formato IANA).
language string Código de idioma por defecto (en, es, pt).
daily_reports_enabled boolean Si los reportes diarios están activos.
kudos_enabled boolean Si la funcionalidad de kudos está habilitada.
mood_enabled boolean Si el seguimiento de estado de ánimo está habilitado.
created_at string (ISO 8601) Cuándo se creó la organización.
curl -sS "https://api.dailybot.com/v1/organization/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Respuesta (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"
}

Códigos de error

HTTP code Cuándo
401 invalid_credentials Credencial ausente, inválida o expirada.
403 plan_free_api_keys_forbidden La organización de la API key está en un plan gratuito.
403 plan_missing_core_api_integrations El plan de la organización no incluye acceso a la API.
429 Throttled — respetar la cabecera Retry-After.

Ver la referencia interactiva completa en /es/developers/api/organization.