Confluence

Visão geral

Confluence é a plataforma de colaboração e gestão do conhecimento da Atlassian, utilizada por equipes para criar, organizar e compartilhar documentação, wikis e planos de projeto em um único espaço. Com a integração Confluence no SquadOS, seus agentes podem criar e atualizar páginas, publicar blog posts, pesquisar conteúdo com CQL, gerenciar tarefas e monitorar mudanças em tempo real — tudo de forma programática.

• Site oficial: https://www.atlassian.com/software/confluence
• Documentação na Composio: docs.composio.dev/toolkits/confluence

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar. Também são suportados S2S_OAUTH2 (OAuth 2.0 server-to-server) e API_KEY (chave de API).

Você vai precisar autorizar o acesso à sua conta Atlassian pela página de conexão segura da Composio. Para configurar credenciais OAuth próprias, consulte o guia da Composio.

Como obter a credencial

Para OAuth 2.0 (padrão), nenhuma credencial manual é necessária — o acesso é autorizado via fluxo OAuth na página da Composio.

Para API Key, siga os passos:

1. Acesse id.atlassian.com/manage-profile/security/api-tokens e faça login na sua conta Atlassian.
2. Clique em Create API token.
3. Dê um nome descritivo ao token (ex.: “SquadOS”) e clique em Create.
4. Copie o token gerado — ele não será exibido novamente.

Dica

Use um token de API dedicado para o SquadOS. Você pode revogar tokens individualmente pela mesma tela sem afetar outras integrações.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Confluence.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Atlassian (OAuth 2.0).
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Perguntas frequentes

Como configurar credenciais OAuth personalizadas para o Confluence?

Para um guia passo a passo sobre como criar e configurar suas próprias credenciais OAuth do Confluence na Composio, consulte Como criar credenciais OAuth para o Confluence.

Ações disponíveis

Adicionar rótulo ao conteúdo

CONFLUENCE_ADD_CONTENT_LABEL

Adiciona rótulos a um conteúdo do Confluence. Use após obter o ID do conteúdo para marcar páginas ou blog posts com metadados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do conteúdo Confluence (página ou blog post) a rotular.
labels	array	Sim	Lista de rótulos a adicionar ao conteúdo. Cada elemento deve ser um objeto com prefix (um de global, team ou my) e name (string alfanumérica com hífens em minúsculas). Passar strings simples ou omitir prefix causa erros de validação de schema.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisa CQL

CONFLUENCE_CQL_SEARCH

Pesquisa conteúdo no Confluence usando a Confluence Query Language (CQL). CQL é uma linguagem de consulta poderosa que permite pesquisar em todo o conteúdo do Confluence com recursos avançados de filtragem: busca de texto completo (text ~ "termo"), busca por título (title ~ "notas de reunião"), filtragem por rótulo (label = "importante"), filtragem por espaço (space = DEV), filtragem por tipo (type = page ou type = blogpost), filtragem por criador (creator = currentUser()), filtragem por data (lastModified > now("-7d")) e consultas combinadas (text ~ "api" AND space = DOCS AND type = page). Esta ação usa o endpoint de pesquisa v1 da API REST do Confluence, que suporta CQL completamente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
cql	string	Sim	Consulta CQL (Confluence Query Language) para pesquisar conteúdo. Exemplos: text ~ "termo" (busca de texto completo), label = "importante" (busca por rótulo), type = page AND space = DEV (páginas no espaço DEV), creator = currentUser() (conteúdo do usuário atual).
limit	integer	Não	Número máximo de resultados a retornar (máx. 250; pode ser limitado a 25–50 ao usar expansões de corpo).
start	integer	Não	Índice inicial para paginação (base 0).
expand	string	Não	Lista separada por vírgulas de propriedades a expandir na resposta. Valores comuns: content.space, content.version, content.body.storage.
excerpt	string	Não	Tipo de trecho a retornar. Padrão: highlight. Valores aceitos: highlight, indexed, none.
includeArchivedSpaces	boolean	Não	Se deve incluir resultados de espaços arquivados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar blog post

CONFLUENCE_CREATE_BLOGPOST

Cria um novo blog post no Confluence. Use quando precisar publicar conteúdo em um espaço específico. A resposta inclui data.id para o ID do post e data._links.base + data._links.webui para a URL.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
body	object	Sim	Corpo do conteúdo do blog post. Deve ser um objeto com representation definido como storage e value contendo marcação válida no formato de armazenamento do Confluence (baseado em XML). Markdown ou strings simples causam erros de validação.
title	string	Sim	Título do novo blog post.
status	string	Sim	Status do blog post. Use current para publicar imediatamente ou draft para salvar como rascunho privado.
spaceId	string	Sim	ID do espaço onde o blog post será criado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar propriedade de blog post

CONFLUENCE_CREATE_BLOGPOST_PROPERTY

Cria uma propriedade em um blog post especificado. Use quando precisar adicionar metadados personalizados a um blog post. Cria um novo par chave-valor no blog post do Confluence especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do blog post do Confluence ao qual adicionar a propriedade.
key	string	Sim	Chave única para a propriedade do blog post.
value	string	Sim	String JSON representando o valor da propriedade do blog post.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar propriedade de quadro branco

CONFLUENCE_CREATE_CONTENT_PROPERTY_FOR_WHITEBOARD

Cria uma nova propriedade de conteúdo em um quadro branco. Use quando precisar anexar metadados personalizados a um quadro branco do Confluence.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
key	string	Sim	Chave/nome da propriedade a criar.
value	string	Sim	String JSON representando o valor da propriedade de conteúdo.
whiteboard_id	string	Sim	ID do quadro branco ao qual adicionar a propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar comentário de rodapé

CONFLUENCE_CREATE_FOOTER_COMMENT

Cria um comentário de rodapé em uma página, blog post, anexo ou conteúdo personalizado do Confluence. Use quando precisar adicionar um comentário sem editar o corpo da página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
body	object	Sim	Conteúdo do corpo do comentário com formato de representação e valor.
pageId	string	Não	ID da página a comentar. Forneça um dos campos: pageId, blogPostId, attachmentId ou customContentId.
blogPostId	string	Não	ID do blog post a comentar. Forneça um dos campos: pageId, blogPostId, attachmentId ou customContentId.
attachmentId	string	Não	ID do anexo a comentar. Forneça um dos campos: pageId, blogPostId, attachmentId ou customContentId.
customContentId	string	Não	ID do conteúdo personalizado a comentar. Forneça um dos campos: pageId, blogPostId, attachmentId ou customContentId.
parentCommentId	string	Não	ID do comentário pai. Forneça este campo para criar uma resposta a um comentário existente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar comentário inline

CONFLUENCE_CREATE_INLINE_COMMENT

Cria um comentário inline em uma página ou blog post do Confluence, destacando um texto específico. Comentários inline permitem comentar em partes específicas do conteúdo sem editar a página. Para comentários de nível superior, especifique o texto a destacar usando inlineCommentProperties. Para respostas a comentários inline existentes, forneça apenas parentCommentId.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
body	object	Sim	Conteúdo do corpo do comentário com formato de representação e valor.
pageId	string	Não	ID da página para criar o comentário inline. Forneça um dos campos: pageId, blogPostId ou parentCommentId.
blogPostId	string	Não	ID do blog post para criar o comentário inline. Forneça um dos campos: pageId, blogPostId ou parentCommentId.
parentCommentId	string	Não	ID do comentário pai para responder. Forneça este campo para criar uma resposta a um comentário inline existente.
inlineCommentProperties	object	Não	Propriedades que determinam a qual texto o comentário inline está anexado. Obrigatório para comentários inline de nível superior (não respostas).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar página

CONFLUENCE_CREATE_PAGE

Cria uma nova página do Confluence em um espaço especificado. Use quando precisar criar nova documentação ou conteúdo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
body	object	Não	Wrapper para o conteúdo do corpo da página.
title	string	Sim	Título da nova página. A unicidade do título é restrita ao mesmo pai: duplicatas são permitidas sob pais diferentes, mas não sob o mesmo pai.
spaceId	string	Sim	ID ou chave do espaço onde a página será criada. Pode ser um ID numérico (ex.: 12345678) ou uma chave de espaço (ex.: DOCS, TEAM). Chaves de espaço são automaticamente convertidas em IDs.
parentId	string	Não	ID da página pai. Se omitido, a API do Confluence colocará a página automaticamente sob a página inicial do espaço. Forneça este campo para criar a página como filha de uma página específica. Deve ser apenas um ID numérico de página.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar propriedade de página

CONFLUENCE_CREATE_PAGE_PROPERTY

Cria uma propriedade em uma página do Confluence. Use quando precisar adicionar metadados personalizados ou configurações a uma página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
key	string	Sim	Chave/nome da propriedade a criar.
value	string	Sim	Valor da propriedade como string JSON. Pode representar qualquer tipo JSON (string, number, object, array).
page_id	string	Sim	ID da página para a qual criar a propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar espaço privado

CONFLUENCE_CREATE_PRIVATE_SPACE

Cria um espaço privado no Confluence. Use quando precisar de um espaço de trabalho isolado, visível apenas pelo criador.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
key	string	Sim	Chave única para o espaço privado; deve ser única e ter no máximo 255 caracteres. Apenas alfanumérico (sem hífens, underscores ou espaços).
name	string	Sim	Nome do espaço privado, visível apenas pelo criador.
description	object	Não	Container para a descrição em texto simples.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar espaço

CONFLUENCE_CREATE_SPACE

Cria um novo espaço no Confluence. Use ao configurar uma nova área de conhecimento para a organização. Deve incluir o campo plain.representation, ex.: {"plain": {"representation": "plain", "value": "texto aqui"}}. Omitir este campo causa erro 400.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
key	string	Sim	Chave única para o espaço. Deve conter apenas caracteres alfanuméricos (letras e números), até 255 caracteres. Underscores e hífens não são permitidos.
name	string	Sim	Nome legível por humanos para o espaço.
type	string	Não	Tipo do espaço: global ou personal.
metadata	string	Não	Metadados opcionais para o espaço como string JSON.
description	object	Não	Objeto de descrição para o espaço do Confluence.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar propriedade de espaço

CONFLUENCE_CREATE_SPACE_PROPERTY

Cria uma nova propriedade em um espaço do Confluence. Use após confirmar o ID do espaço ao adicionar metadados personalizados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
key	string	Sim	Chave única para a propriedade do espaço.
value	string	Sim	String JSON representando o valor da propriedade do espaço.
spaceId	string	Sim	ID do espaço ao qual adicionar a propriedade.
version	object	Não	Metadados de versão opcionais para a nova propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Criar quadro branco

CONFLUENCE_CREATE_WHITEBOARD

Cria um novo quadro branco no Confluence. Use quando precisar iniciar uma sessão colaborativa de quadro branco.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
title	string	Não	Título do quadro branco.
spaceId	string	Sim	ID do espaço onde o quadro branco será criado.
parentId	string	Não	ID do conteúdo pai sob o qual o quadro branco será criado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir propriedade de blog post

CONFLUENCE_DELETE_BLOGPOST_PROPERTY

Exclui uma propriedade de blog post. Use quando precisar remover metadados personalizados de um blog post especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do blog post do Confluence que contém a propriedade.
propertyId	string	Sim	ID da propriedade do blog post a excluir. Pode ser um ID numérico ou uma string de chave de propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir propriedade de conteúdo de página

CONFLUENCE_DELETE_CONTENT_PROPERTY_FOR_PAGE_BY_ID

Exclui uma propriedade de conteúdo de uma página pelo ID da propriedade. Use quando precisar remover metadados personalizados de uma página para limpeza ou auditoria.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
pageId	string	Sim	ID da página do Confluence da qual excluir a propriedade.
propertyId	string	Sim	ID da propriedade de conteúdo a excluir da página. Pode ser um ID numérico ou uma string de chave de propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir propriedade de conteúdo de quadro branco

CONFLUENCE_DELETE_CONTENT_PROPERTY_FOR_WHITEBOARD_BY_ID

Exclui uma propriedade de conteúdo de um quadro branco pelo ID da propriedade. Use quando precisar remover metadados personalizados de um quadro branco.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
propertyId	string	Sim	ID da propriedade a excluir do quadro branco. Pode ser um ID numérico ou uma string de chave de propriedade.
whiteboardId	string	Sim	ID do quadro branco do qual excluir a propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir página

CONFLUENCE_DELETE_PAGE

Exclui uma página do Confluence. Use com cautela, pois remove permanentemente a página e seu conteúdo sem opção de recuperação. Em fluxos de migração, confirme que todas as páginas de destino foram criadas com sucesso antes de excluir as páginas de origem — falhas parciais na criação combinadas com exclusão resultam em perda irrecuperável de dados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da página a excluir.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir espaço

CONFLUENCE_DELETE_SPACE

Exclui um espaço do Confluence pela sua chave. Use quando precisar remover permanentemente um espaço.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
space_key	string	Sim	Chave do espaço a excluir.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Excluir propriedade de espaço

CONFLUENCE_DELETE_SPACE_PROPERTY

Exclui uma propriedade de espaço. Use quando precisar remover uma propriedade de um espaço do Confluence após revisão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
propertyId	string	Sim	ID da propriedade do espaço a excluir. Pode ser um ID numérico ou uma string de chave de propriedade.
spaceIdOrKey	integer	Sim	ID numérico Long do espaço que contém a propriedade. Deve ser um ID numérico de espaço, não uma chave de espaço ou UUID.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Baixar anexo

CONFLUENCE_DOWNLOAD_ATTACHMENT

Baixa um anexo de uma página do Confluence e retorna uma URL pública acessível no S3. Use quando precisar compartilhar o anexo com usuários que não têm acesso ao Confluence. Primeiro use CONFLUENCE_GET_ATTACHMENTS para listar os anexos e obter o ID do anexo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
pageId	string	Sim	ID da página do Confluence que contém o anexo.
attachmentId	string	Sim	ID do anexo a baixar (ex.: att65825).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos de anexo

CONFLUENCE_GET_ATTACHMENT_LABELS

Lista rótulos de um anexo. Use após confirmar o ID do anexo para buscar seus rótulos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do anexo do Confluence para recuperar os rótulos.
sort	string	Não	Ordenar o resultado por um campo específico.
limit	integer	Não	Número máximo de rótulos a retornar por página (1–250).
cursor	string	Não	Cursor opaco para paginação. Retornado no cabeçalho de resposta Link para buscar a próxima página.
prefix	string	Não	Filtrar rótulos pelo prefixo. Valores: my, team, global, system.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter anexos

CONFLUENCE_GET_ATTACHMENTS

Recupera os anexos de uma página do Confluence. Use após confirmar o ID da página para listar seus anexos (suporta paginação).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de anexos a retornar por página. O Confluence limita a 200.
start	integer	Não	Índice base zero do primeiro item a retornar (offset de paginação).
pageId	string	Sim	ID da página do Confluence cujos anexos serão recuperados.
mediaType	string	Não	Filtrar anexos por tipo MIME (ex.: image/png, application/pdf).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter logs de auditoria

CONFLUENCE_GET_AUDIT_LOGS

Recupera registros de auditoria do Confluence. Use quando precisar buscar e filtrar logs de auditoria para conformidade ou resolução de problemas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de registros de auditoria a retornar por página.
start	integer	Não	Índice base zero do primeiro registro de auditoria a retornar (offset de paginação).
endDate	integer	Não	Fim do intervalo de timestamp dos registros de auditoria (época em milissegundos).
startDate	integer	Não	Início do intervalo de timestamp dos registros de auditoria (época em milissegundos).
searchString	string	Não	Busca de texto livre para filtrar registros de auditoria por resumo ou categoria.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter blog post por ID

CONFLUENCE_GET_BLOGPOST_BY_ID

Recupera um blog post específico do Confluence pelo seu ID. Use quando tiver um ID de blog post e precisar de metadados detalhados e conteúdo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único do blog post do Confluence a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos de blog post

CONFLUENCE_GET_BLOGPOST_LABELS

Recupera rótulos de um blog post específico do Confluence pelo ID. Use após obter o ID do blog post para listar seus rótulos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do blog post do Confluence para recuperar os rótulos.
limit	integer	Não	Número máximo de rótulos a retornar por página.
start	integer	Não	Índice base zero do primeiro rótulo a retornar (offset de paginação).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter contagem de curtidas de blog post

CONFLUENCE_GET_BLOGPOST_LIKE_COUNT

Obtém a contagem de curtidas de um blog post do Confluence. Use após confirmar o ID do blog post para recuperar o total de curtidas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do blog post do Confluence para recuperar a contagem de curtidas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter operações de blog post

CONFLUENCE_GET_BLOGPOST_OPERATIONS

Recupera as operações permitidas para um blog post do Confluence. Use após confirmar o ID do blog post para ver as ações permitidas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador do blog post do Confluence para consultar as operações.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar blog posts

CONFLUENCE_GET_BLOG_POSTS

Recupera uma lista de blog posts. Use quando precisar de uma lista paginada de blog posts do Confluence.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de itens a retornar por página.
cursor	string	Não	Cursor de paginação opaco para buscar a próxima página de resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar blog posts por rótulo

CONFLUENCE_GET_BLOG_POSTS_FOR_LABEL

Lista todos os blog posts associados a um rótulo específico. Use quando tiver um ID de rótulo e precisar recuperar os blog posts associados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do rótulo para recuperar os blog posts.
limit	integer	Não	Número máximo de itens a retornar por página.
cursor	string	Não	Cursor de paginação opaco para buscar a próxima página de resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter detalhes de versão de blog post

CONFLUENCE_GET_BLOGPOST_VERSION_DETAILS

Recupera detalhes de uma versão específica de um blog post. Use quando tiver blogpostId e versionNumber e precisar de metadados detalhados para aquela versão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
blogpostId	string	Sim	Identificador único do blog post do Confluence.
versionNumber	integer	Sim	Número da versão do blog post a recuperar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar versões de blog post

CONFLUENCE_GET_BLOGPOST_VERSIONS

Recupera todas as versões de um blog post específico. Use quando tiver um blogpostId e precisar listar os números de versão.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de itens de versão a retornar por página.
cursor	string	Não	Cursor para paginação. Use o valor da resposta anterior para buscar a próxima página.
blogpostId	string	Sim	Identificador único do blog post do Confluence.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter páginas filhas

CONFLUENCE_GET_CHILD_PAGES

Lista todas as páginas filhas diretas de uma página do Confluence. Use quando tiver um ID de página pai e precisar descobrir seus descendentes diretos. A resposta aninha os dados das páginas filhas em data.data.results; desempacote antes de iterar. Pagine usando o cursor de _links.next até não haver mais resultados para evitar perder filhos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da página do Confluence para recuperar as páginas filhas. Os IDs retornados podem ser strings não-numéricas; não assuma formato inteiro ao armazenar ou passar para chamadas subsequentes.
sort	string	Não	Opções de ordenação para páginas filhas: id, -id, created-date, -created-date, modified-date, -modified-date, child-position, -child-position.
limit	integer	Não	Número máximo de itens a retornar por página. Limite máximo: 100. Pagine até que _links.next esteja ausente para garantir que todos os filhos sejam recuperados.
cursor	string	Não	Cursor para paginação. Use o cursor de _links.next da resposta anterior para obter a próxima página de resultados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter propriedades de conteúdo de blog post

CONFLUENCE_GET_CONTENT_PROPERTIES_FOR_BLOG_POST

Recupera todas as propriedades de conteúdo de um blog post. Use quando precisar listar propriedades de metadados definidas em um blog post específico do Confluence.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de propriedades a retornar por página.
start	integer	Não	Índice base zero da primeira propriedade a retornar (offset de paginação).
blogpost_id	string	Sim	Identificador do blog post do Confluence para recuperar as propriedades.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter propriedades de conteúdo de página

CONFLUENCE_GET_CONTENT_PROPERTIES_FOR_PAGE

Recupera todas as propriedades de conteúdo de uma página. Use quando precisar listar propriedades de metadados definidas em uma página específica do Confluence.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de propriedades a retornar por página (máx. 200).
cursor	string	Não	Cursor de paginação opaco para buscar a próxima página de resultados.
page_id	string	Sim	Identificador da página do Confluence para recuperar as propriedades.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter restrições de conteúdo

CONFLUENCE_GET_CONTENT_RESTRICTIONS

Recupera restrições de um item de conteúdo do Confluence. Use quando precisar ver quem pode visualizar ou editar uma página ou blog post.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do conteúdo para recuperar as restrições.
expand	array	Não	Propriedades separadas por vírgula para expandir na resposta, ex.: restrictables.operation, user.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter usuário atual

CONFLUENCE_GET_CURRENT_USER

Obtém informações sobre o usuário atualmente autenticado — sempre vinculado à conta associada à conexão configurada, não a usuários arbitrários. Use CONFLUENCE_SEARCH_USERS para consultar outros usuários. A resposta contém metadados aninhados; campos principais incluem accountId, displayName e email.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter comentários inline de blog post

CONFLUENCE_GET_INLINE_COMMENTS_FOR_BLOG_POST

Recupera comentários inline de um blog post do Confluence. Use quando precisar de detalhes de comentários inline pelo ID do blog post.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único do blog post para recuperar os comentários inline.
sort	string	Não	Ordem dos resultados. Use prefixo - para ordem decrescente. Valores: created-date, -created-date, modified-date, -modified-date.
limit	integer	Não	Número máximo de comentários inline a retornar por página (padrão 25, máx. 250).
cursor	string	Não	Cursor para paginação. Use o cursor de _links.next da resposta anterior.
body_format	string	Não	Formato de conteúdo para o corpo do comentário. Valores: storage, atlas_doc_format.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos

CONFLUENCE_GET_LABELS

Recupera todos os rótulos de um site do Confluence; use para descoberta de rótulos quando precisar listar ou paginar por rótulos. Para filtragem baseada em rótulos, use CONFLUENCE_GET_LABELS_FOR_PAGE ou CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de rótulos a retornar por página.
start	integer	Não	Índice base zero do primeiro rótulo a retornar (offset de paginação).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos de página

CONFLUENCE_GET_LABELS_FOR_PAGE

Recupera rótulos de uma página específica do Confluence pelo ID. Os rótulos são retornados em data.results[*].name e não estão disponíveis nas respostas de CONFLUENCE_GET_PAGES. Use após obter o ID da página para listar seus rótulos. Pagine usando start e limit para evitar perder rótulos quando a contagem exceder 25.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador da página do Confluence para recuperar os rótulos.
limit	integer	Não	Número máximo de rótulos a retornar por página.
start	integer	Não	Índice base zero do primeiro rótulo a retornar (offset de paginação). Incremente pelo valor de limit iterativamente para paginar por todos os rótulos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos de espaço

CONFLUENCE_GET_LABELS_FOR_SPACE

Lista rótulos de um espaço. Use quando precisar recuperar rótulos de um espaço específico.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do espaço para recuperar os rótulos (ID numérico do espaço).
sort	string	Não	Ordem dos resultados. Use prefixo - para ordem decrescente. Valores: created-date, -created-date, id, -id, name, -name.
limit	integer	Não	Número máximo de rótulos a retornar por página (padrão 25, máx. 250).
cursor	string	Não	Cursor para paginação. Use o cursor da resposta anterior para obter a próxima página.
prefix	string	Não	Filtrar rótulos por prefixo. Valores: my, team, global, system.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rótulos de conteúdo de espaço

CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT

Lista rótulos de todo o conteúdo de um espaço. Use quando precisar recuperar ou filtrar rótulos de conteúdo por espaço, com paginação e filtragem opcional por prefixo. Para descoberta de rótulos em um espaço antes da filtragem por página, use esta ação primeiro e depois CONFLUENCE_GET_LABELS_FOR_PAGE.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do espaço para listar os rótulos de conteúdo.
limit	integer	Não	Número máximo de rótulos a retornar por página.
start	integer	Não	Índice base zero do primeiro rótulo a retornar (offset de paginação).
prefix	string	Não	Filtrar rótulos por este prefixo (ex.: global, page-).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter ancestrais de página

CONFLUENCE_GET_PAGE_ANCESTORS

Recupera todos os ancestrais de uma página do Confluence pelo seu ID. Use quando precisar da hierarquia completa de páginas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da página do Confluence para recuperar os ancestrais.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter página por ID

CONFLUENCE_GET_PAGE_BY_ID

Recupera uma página do Confluence pelo seu ID. Use quando tiver um ID de página e precisar de metadados detalhados e conteúdo. O corpo da resposta está em body.storage.value no formato de armazenamento do Confluence (HTML); remova as tags antes de usar como texto simples. Antes de chamar CONFLUENCE_UPDATE_PAGE, busque a versão mais recente aqui — aquela ação requer version.number = atual + 1, caso contrário ocorre um conflito 409.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID numérico Long da página do Confluence a recuperar. Deve ser um valor numérico long, não um UUID ou identificador string.
draft	boolean	Não	Se deve retornar a versão de rascunho (padrão: false).
version	integer	Não	Versão específica da página a recuperar (padrão: mais recente).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter comentários de rodapé de página

CONFLUENCE_GET_PAGE_FOOTER_COMMENTS

Recupera comentários de rodapé (não-inline) de uma página do Confluence. Use quando precisar coletar feedback de revisão deixado como comentários padrão de página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da página para recuperar os comentários de rodapé.
sort	string	Não	Ordem dos resultados. Use prefixo - para ordem decrescente. Valores: created-date, -created-date, modified-date, -modified-date.
limit	integer	Não	Número máximo de comentários de rodapé a retornar por página (padrão 50, máx. 250).
cursor	string	Não	Cursor para paginação. Use o cursor de _links.next da resposta anterior.
status	array	Não	Filtrar comentários por status. Pode incluir múltiplos status.
body_format	string	Não	Formato de conteúdo para o corpo do comentário. Valores: storage, atlas_doc_format.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter comentários inline de página

CONFLUENCE_GET_PAGE_INLINE_COMMENTS

Recupera comentários inline de uma página do Confluence. Use quando precisar de detalhes de comentários inline pelo ID da página.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	ID numérico da página para recuperar os comentários inline.
sort	string	Não	Ordem dos resultados. Use prefixo - para ordem decrescente. Valores: created-date, -created-date, modified-date, -modified-date.
limit	integer	Não	Número máximo de comentários inline a retornar por página (padrão 25, máx. 250).
cursor	string	Não	Cursor para paginação. Use o cursor de _links.next da resposta anterior.
status	array	Não	Filtrar comentários por status. Passe um array de valores de status.
body_format	string	Não	Formato de conteúdo para o corpo do comentário. Valores: storage, atlas_doc_format.
resolution_status	array	Não	Filtrar comentários por status de resolução. Passe um array de valores (ex.: open, resolved).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter contagem de curtidas de página

CONFLUENCE_GET_PAGE_LIKE_COUNT

Obtém a contagem de curtidas de uma página do Confluence. Use após confirmar o ID da página para recuperar o total de curtidas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador da página do Confluence para recuperar a contagem de curtidas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar páginas

CONFLUENCE_GET_PAGES

Recupera uma lista paginada de páginas do Confluence. Os resultados são limitados ao escopo de permissões do usuário autenticado; resultados vazios podem refletir restrições de acesso. Omitir filtros como spaceId ou status pode retornar conjuntos de resultados inesperadamente amplos. Rótulos não estão incluídos nos resultados; use CONFLUENCE_GET_LABELS_FOR_PAGE para dados de rótulos. Timestamps são strings ISO 8601 UTC.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
sort	string	Não	Ordem dos resultados. Valores: id, -id, created-date, -created-date, modified-date, -modified-date, title, -title.
limit	integer	Não	Número máximo de páginas a retornar por página. O Confluence limita a 250.
title	string	Não	Filtrar por título de página (correspondência exata).
cursor	string	Não	Cursor de paginação opaco. Use o link next de uma resposta anterior para continuar. Itere até que nenhum link next seja retornado.
status	string	Não	Filtrar por status de página. Valores: current, archived, deleted, trashed.
subtype	string	Não	Filtrar por subtipo de página. Valores: live, page.
space_id	string	Não	Filtrar por ID(s) de espaço. Forneça um único ID ou uma lista de IDs.
body_format	string	Não	Representação de corpo a incluir nos resultados. Valores: storage ou atlas_doc_format.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar versões de página

CONFLUENCE_GET_PAGE_VERSIONS

Recupera todas as versões de uma página específica do Confluence. Use para auditar o histórico de edições ou para obter o version.number mais recente antes de chamar CONFLUENCE_UPDATE_PAGE — usar um version.number desatualizado causa um erro 409 Conflict.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da página do Confluence. Formato string; difere do long numérico esperado por CONFLUENCE_GET_PAGE_BY_ID.
limit	integer	Não	Número máximo de versões a retornar por página. Versões antigas são omitidas silenciosamente se a paginação não for seguida.
start	integer	Não	Índice base zero da primeira versão a retornar (offset de paginação).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter espaço por ID

CONFLUENCE_GET_SPACE_BY_ID

Recupera um espaço do Confluence pelo seu ID. Use quando precisar de metadados detalhados de um espaço específico. Nomes de espaço não são únicos; use o spaceId numérico ou spaceKey da resposta para identificação estável em operações subsequentes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID numérico do espaço (ex.: 557060). NÃO é a chave do espaço (ex.: GTS). Use CONFLUENCE_GET_SPACES para encontrar o ID numérico de um espaço a partir da sua chave.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter conteúdo de espaço

CONFLUENCE_GET_SPACE_CONTENTS

Recupera conteúdo de um espaço do Confluence. Use quando precisar listar páginas, blog posts ou anexos de uma chave de espaço específica. Os resultados estão em data.results (não data.page.results). Pagine via start/limit (máx. 200/requisição); siga response._links.next até ausente para evitar perder conteúdo. Retorna apenas conteúdo acessível ao usuário autenticado. O Atlassian Cloud aplica limites de taxa HTTP 429; limite a ~1–2 requisições/segundo e respeite os cabeçalhos Retry-After.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
type	string	Não	Tipo de conteúdo a retornar: page, blogpost, attachment.
limit	integer	Não	Número máximo de itens a retornar por página. O Confluence limita a 200.
start	integer	Não	Índice base zero do primeiro item a retornar (offset de paginação).
status	string	Não	Status do conteúdo a retornar: current, trashed, draft, historical.
spaceKey	string	Sim	Chave do espaço do qual recuperar o conteúdo.
postingDay	string	Não	Para blog posts, filtrar por data de publicação (data ISO, yyyy-MM-dd).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter propriedades de espaço

CONFLUENCE_GET_SPACE_PROPERTIES

Obtém propriedades de um espaço do Confluence. Use quando precisar recuperar metadados personalizados ou configurações armazenadas como propriedades de espaço.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do espaço para obter as propriedades.
key	array	Não	Filtrar por chave(s) de propriedade. Se não fornecido, retorna todas as propriedades.
limit	integer	Não	Número máximo de propriedades a retornar por página. O Confluence limita a 200.
start	integer	Não	Índice base zero do primeiro item a retornar (offset de paginação).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar espaços

CONFLUENCE_GET_SPACES

Recupera uma lista paginada de espaços do Confluence com filtragem opcional. Pagine incrementando start em passos de limit até que menos resultados que limit sejam retornados. Os resultados são limitados aos espaços visíveis pelo usuário autenticado. Use spaceKey ou ID numérico de espaço (não nome de exibição) para identificação estável em chamadas subsequentes. Filtros combinados aplicam lógica AND — relaxe os filtros antes de concluir que um espaço está ausente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
type	string	Não	Tipo de espaço: global ou personal.
label	array	Não	Filtrar por rótulos; espaços devem ter pelo menos um desses rótulos.
limit	integer	Não	Número máximo de espaços a retornar por página. O Confluence limita a 200.
start	integer	Não	Índice base zero do primeiro item a retornar (offset de paginação).
expand	array	Não	Propriedades a expandir na resposta (ex.: description, icon, metadata).
status	string	Não	Status do espaço: current (ativo) ou archived.
spaceKey	array	Não	Filtrar por chave(s) de espaço; aceita uma ou mais chaves canônicas de espaço.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter tarefas

CONFLUENCE_GET_TASKS

Lista tarefas (itens de ação) do Confluence com filtragem por responsável, criador, espaço, página, blog post, status e datas. Use quando precisar recuperar itens de ação de usuários sem pesquisa não confiável por palavra-chave “TODO”.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de tarefas a retornar por página. O Confluence limita a 250.
cursor	string	Não	Cursor de paginação opaco. Use o link next da resposta anterior para continuar.
status	string	Não	Filtrar tarefas por status (ex.: complete, incomplete).
page_id	string	Não	Filtrar por ID(s) de página. Forneça um único ID ou uma lista de IDs.
task_id	string	Não	Filtrar por ID(s) de tarefa específico(s). Forneça um único ID ou uma lista de IDs.
space_id	string	Não	Filtrar por ID(s) de espaço. Forneça um único ID ou uma lista de IDs.
created_by	string	Não	Filtrar pelo(s) criador(es) da tarefa. Forneça ID(s) de conta Atlassian.
assigned_to	string	Não	Filtrar pelo(s) responsável(eis) da tarefa. Forneça ID(s) de conta Atlassian.
blogpost_id	string	Não	Filtrar por ID(s) de blog post. Forneça um único ID ou uma lista de IDs.
body_format	string	Não	Representação de corpo a incluir nos resultados de tarefas. Valores: storage ou atlas_doc_format.
completed_by	string	Não	Filtrar por quem concluiu a(s) tarefa(s). Forneça ID(s) de conta Atlassian.
include_blank_tasks	boolean	Não	Se deve incluir tarefas sem conteúdo ou em branco.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter usuário anônimo

CONFLUENCE_GET_USER_ANONYMOUS

Recupera informações sobre o usuário anônimo. Use quando precisar obter detalhes de usuário convidado antes de interações não autenticadas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar conteúdo

CONFLUENCE_SEARCH_CONTENT

Pesquisa conteúdo filtrando páginas da API v2 do Confluence com classificação inteligente. Como o endpoint de pesquisa nativo foi descontinuado, esta ação: (1) busca páginas do endpoint v2 com paginação (até 300 páginas), (2) aplica filtragem inteligente no lado do cliente com pontuação de relevância, (3) retorna resultados classificados por qualidade de correspondência (frase exata > todas as palavras > correspondências parciais). NOTA: Apenas títulos de páginas são pesquisados — consultas que correspondem apenas ao corpo do conteúdo não retornam resultados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de resultados a retornar.
query	string	Sim	Consulta de pesquisa para encontrar páginas correspondentes. A pesquisa procura este texto nos títulos de páginas com correspondência inteligente: (1) correspondências de frase exata (maior prioridade), (2) todas as palavras presentes no título (prioridade média), (3) correspondências parciais de palavras (menor prioridade). Sem distinção de maiúsculas/minúsculas e suporta múltiplas palavras.
start	integer	Não	Índice inicial para paginação.
expand	string	Não	Lista separada por vírgulas de propriedades a expandir na resposta.
spaceKey	string	Não	Limitar pesquisa a um espaço específico pela chave do espaço. Os resultados não estão estritamente limitados a este espaço; inspecione spaceId nos resultados retornados para confirmar o escopo.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar usuários

CONFLUENCE_SEARCH_USERS

Pesquisa usuários usando consultas específicas de usuário da Confluence Query Language (CQL).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de usuários por resultado a retornar.
cursor	string	Não	Usado para paginação. O cursor para a próxima página de resultados.
accountId	string	Não	Filtrar por ID de conta de usuário.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar blog post

CONFLUENCE_UPDATE_BLOGPOST

Atualiza o título ou conteúdo de um blog post do Confluence. Use quando precisar modificar um blog post existente. Certifique-se de ter o número de versão mais recente antes de chamar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do blog post a atualizar.
body	object	Sim	Novo conteúdo para o corpo do blog post. Forneça o corpo no formato de armazenamento.
title	string	Sim	Novo título para o blog post.
status	string	Não	Status do blog post. Padrão: current se não fornecido. Valores: current, draft.
spaceId	string	Sim	ID do espaço que contém o blog post.
version	object	Sim	Objeto de versão contendo o novo número de versão e metadados opcionais.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar propriedade de blog post

CONFLUENCE_UPDATE_BLOGPOST_PROPERTY

Atualiza uma propriedade de um blog post especificado. Use quando precisar modificar metadados personalizados em um blog post.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID do blog post do Confluence a atualizar.
value	string	Sim	Nova string JSON de valor para a propriedade especificada.
propertyId	string	Sim	ID da propriedade do blog post a atualizar. Pode ser um ID numérico ou uma string de chave de propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar propriedade de conteúdo de página

CONFLUENCE_UPDATE_CONTENT_PROPERTY_FOR_PAGE_BY_ID

Atualiza uma propriedade de conteúdo em uma página do Confluence. Use quando precisar modificar uma propriedade de metadados existente pelo seu ID.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
value	string	Sim	Nova string JSON de valor para a propriedade especificada.
pageId	string	Sim	ID da página do Confluence para atualizar a propriedade.
propertyId	string	Sim	ID da propriedade de conteúdo a atualizar na página. Pode ser um ID numérico ou uma string de chave de propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar propriedade de conteúdo de quadro branco

CONFLUENCE_UPDATE_CONTENT_PROPERTY_FOR_WHITEBOARD_BY_ID

Atualiza uma propriedade de conteúdo em um quadro branco. Use quando precisar modificar metadados em um quadro branco do Confluence.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
value	string	Sim	Nova string JSON de valor para a propriedade de conteúdo especificada.
propertyId	string	Sim	ID da propriedade de conteúdo a atualizar no quadro branco. Pode ser um ID numérico ou uma string de chave de propriedade.
whiteboardId	string	Sim	ID do quadro branco do Confluence que contém a propriedade a atualizar.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar página

CONFLUENCE_UPDATE_PAGE

Atualiza uma página existente do Confluence, substituindo todo o conteúdo da página. Use quando precisar modificar documentação ou conteúdo existente.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da página a atualizar. Deve ser uma string; converta de IDs numéricos retornados por CONFLUENCE_GET_PAGE_BY_ID antes de passar.
body	object	Sim	Corpo do conteúdo atualizado da página. Requer value (o conteúdo no formato especificado) e representation (storage para formato de armazenamento/XHTML do Confluence, ou atlas_doc_format para Atlassian Document Format/ADF). Substitui todo o conteúdo da página — sempre envie o conteúdo completo desejado. Forneça exatamente uma chave de representação (storage, atlas_doc_format ou wiki) cujo valor corresponda ao campo representation; chaves incompatíveis ou múltiplas causam erros de validação.
title	string	Sim	Título atualizado da página. IMPORTANTE: O Confluence exige títulos únicos por espaço. Se alterar o título para um que já existe no mesmo espaço, a atualização falhará.
spaceId	string	Não	ID do espaço que contém a página. Opcional se o espaço da página não precisar ser alterado.
version	object	Sim	Informações de versão para a atualização. Deve incluir number definido como exatamente versão_atual + 1. Busque a versão atual via CONFLUENCE_GET_PAGE_BY_ID antes de atualizar. Em caso de conflito 409, rebusque a versão mais recente e tente novamente.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar propriedade de espaço

CONFLUENCE_UPDATE_SPACE_PROPERTY

Atualiza uma propriedade de espaço. Use quando precisar modificar metadados personalizados armazenados em um espaço do Confluence (requer buscar a versão atual da propriedade primeiro).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
value	string	Sim	Nova string JSON de valor para a propriedade de espaço especificada.
spaceId	integer	Sim	ID do espaço ao qual a propriedade pertence.
propertyId	string	Sim	ID da propriedade de espaço a atualizar. Pode ser um ID numérico ou uma string de chave de propriedade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar tarefa

CONFLUENCE_UPDATE_TASK

Atualiza o status de uma tarefa do Confluence. Use quando precisar marcar tarefas como concluídas ou pendentes em fluxos de trabalho ou painéis.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da tarefa a atualizar.
status	string	Sim	Status da tarefa. Valores: complete, incomplete.
body_format	string	Não	Formato de corpo opcional para a resposta. Valores: storage, atlas_doc_format.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.