Saltar al contenido principal

kobana kadu organization

Organización del token

Comandos de kobana kadu organization. Toda opción global (Opciones globales) vale aquí.

ComandoHTTPDescripción
organizationGET /v1/organizationOrganización del token
organization slack-installations listGET /v1/organization/slack_installationsInstalaciones del bot de Slack de la organización
organization slack-installations updatePATCH /v1/organization/slack_installations/{installationId}Configura una instalación de Slack
organization slack-installations deleteDELETE /v1/organization/slack_installations/{installationId}Quita una instalación de Slack
organization updatePATCH /v1/organizationActualiza la organización del token

organization​

Organización del token

kobana kadu organization [OPCIONES] [COMANDO]

GET /v1/organization

Devuelve solo la organización del token (la del claim org). No recibe id y no lista: no hay forma de leer otra organización por esta API.

Respuestas

HTTPDescripción
200OK
404not found
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

organization slack-installations list​

Instalaciones del bot de Slack de la organización

kobana kadu organization slack-installations list [OPCIONES]

GET /v1/organization/slack_installations

Workspaces de Slack vinculados a la organización del token (siempre la del token; sin id).

Respuestas

HTTPDescripción
200OK
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

organization slack-installations update​

Configura una instalación de Slack

kobana kadu organization slack-installations update [INSTALLATIONID] [OPCIONES]

PATCH /v1/organization/slack_installations/{installationId}

Dónde responde el bot (allowed_channel_types), archivos de salida como enlace o adjunto (files_mode, max_upload_bytes hasta 100 MB) y detalle en el hilo (log_detail).

Argumentos de la ruta: installationId

Cuerpo de la solicitud

NombreTipoObligatorioDescripción
allowed_channel_typesarray<string>no
files_modestringnoValores: link, upload.
max_upload_bytesintegerno
log_detailstringnoValores: milestones, verbose.

Otros campos y objetos anidados: kobana schema kadu.organization.slack-installations.update.

Respuestas

HTTPDescripción
200OK
400VALIDATION_ERROR
404NOT_FOUND
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (o CONFLICT de la ruta)
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

organization slack-installations delete​

Quita una instalación de Slack

kobana kadu organization slack-installations delete [INSTALLATIONID] [OPCIONES]

DELETE /v1/organization/slack_installations/{installationId}

Exige el nivel delete (o all). Revoca el token del bot en Slack y deshace las conexiones de cuenta.

Argumentos de la ruta: installationId

Respuestas

HTTPDescripción
200OK
404NOT_FOUND
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).

organization update​

Actualiza la organización del token

kobana kadu organization update [OPCIONES]

PATCH /v1/organization

Modifica solo la organización del token (la del claim org); no recibe id. monthly_cost_limit y bypass_subscription los define Kobana y se rechazan (403).

Cuerpo de la solicitud

NombreTipoObligatorioDescripción
labelstringno
timezonestringno
default_localestringnoValores: pt-BR, en-US, es-ES.
custom_metadataobjectno

Otros campos y objetos anidados: kobana schema kadu.organization.update.

Respuestas

HTTPDescripción
200OK
400VALIDATION_ERROR
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (o CONFLICT de la ruta)
503AS_UNAVAILABLE — la verificación del token no está disponible (Authorization Server fuera de línea o configuración ausente). Intenta de nuevo (Retry-After).