Pular para o conteúdo principal

kobana kadu organization

Organização do token

Comandos de kobana kadu organization. Toda opção global (Opções globais) vale aqui.

ComandoHTTPDescrição
organizationGET /v1/organizationOrganização do token
organization slack-installations listGET /v1/organization/slack_installationsInstalações do bot do Slack da organização
organization slack-installations updatePATCH /v1/organization/slack_installations/{installationId}Configura uma instalação do Slack
organization slack-installations deleteDELETE /v1/organization/slack_installations/{installationId}Remove uma instalação do Slack
organization updatePATCH /v1/organizationAtualiza a organização do token

organization​

Organização do token

kobana kadu organization [OPÇÕES] [COMANDO]

GET /v1/organization

Devolve apenas a organização do token (a da claim org). Não recebe id e não lista: não há como ler outra organização por esta API.

Respostas

HTTPDescrição
200OK
404not found
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

organization slack-installations list​

Instalações do bot do Slack da organização

kobana kadu organization slack-installations list [OPÇÕES]

GET /v1/organization/slack_installations

Workspaces do Slack ligados à organização do token (sempre a do token; sem id).

Respostas

HTTPDescrição
200OK
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

organization slack-installations update​

Configura uma instalação do Slack

kobana kadu organization slack-installations update [INSTALLATIONID] [OPÇÕES]

PATCH /v1/organization/slack_installations/{installationId}

Onde o bot responde (allowed_channel_types), arquivos de saída como link ou anexo (files_mode, max_upload_bytes até 100 MB) e detalhe na thread (log_detail).

Argumentos do caminho: installationId

Corpo da requisição

NomeTipoObrigatórioDescrição
allowed_channel_typesarray<string>não
files_modestringnãoValores: link, upload.
max_upload_bytesintegernão
log_detailstringnãoValores: milestones, verbose.

Outros campos e objetos aninhados: kobana schema kadu.organization.slack-installations.update.

Respostas

HTTPDescrição
200OK
400VALIDATION_ERROR
404NOT_FOUND
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (ou CONFLICT da rota)
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

organization slack-installations delete​

Remove uma instalação do Slack

kobana kadu organization slack-installations delete [INSTALLATIONID] [OPÇÕES]

DELETE /v1/organization/slack_installations/{installationId}

Exige o nível delete (ou all). Revoga o token do bot no Slack e desfaz as conexões de conta.

Argumentos do caminho: installationId

Respostas

HTTPDescrição
200OK
404NOT_FOUND
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).

organization update​

Atualiza a organização do token

kobana kadu organization update [OPÇÕES]

PATCH /v1/organization

Altera apenas a organização do token (a da claim org); não recebe id. monthly_cost_limit e bypass_subscription são definidos pela Kobana e recusados (403).

Corpo da requisição

NomeTipoObrigatórioDescrição
labelstringnão
timezonestringnão
default_localestringnãoValores: pt-BR, en-US, es-ES.
custom_metadataobjectnão

Outros campos e objetos aninhados: kobana schema kadu.organization.update.

Respostas

HTTPDescrição
200OK
400VALIDATION_ERROR
409IDEMPOTENCY_KEY_REUSED / IDEMPOTENCY_REQUEST_IN_PROGRESS (ou CONFLICT da rota)
503AS_UNAVAILABLE — a verificação do token está indisponível (Authorization Server fora do ar ou configuração ausente). Tente de novo (Retry-After).