> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Craft API

> Conecte o Craft a ferramentas externas, automatize fluxos de trabalho e crie integrações personalizadas com a Craft API.

O Craft está ficando mais flexível e poderoso com a introdução da nossa API. Essa nova capacidade permite que você conecte o Craft a ferramentas externas, automatize fluxos de trabalho e crie integrações personalizadas que adaptam o Craft às suas necessidades.

## O que é uma API?

Uma API (Application Programming Interface) permite que aplicações diferentes se comuniquem entre si de forma segura. Na prática, isso significa que você pode usar a Craft API para:

* Enviar ou receber dados de outros serviços
* Disparar ações no Craft com base em eventos em outro app
* Construir ferramentas, painéis ou automações personalizados
* Conectar o Craft a Assistentes de IA como Claude ou ChatGPT através do MCP ou outros métodos de integração

As APIs possibilitam que o Craft funcione em conjunto com as ferramentas que você já usa – sem cópias manuais ou tarefas repetitivas.

## Como a Craft API funciona

Crie uma **API Connection** na **Imagine tab** no sidebar para compartilhar as partes certas do seu workspace com ferramentas externas.

Você pode escolher:

* Conectar **todas as suas Notas Diárias**, ou
* Criar uma **conexão personalizada** onde você seleciona um ou mais Documentos específicos para incluir

Para cada conexão, você define as permissões de acesso e a visibilidade, para que você mantenha o controle do que é compartilhado. O Craft então gera um **API endpoint** único para essa conexão, que você pode inserir nas suas ferramentas ou fluxos de trabalho baseados em API. Essas ferramentas só terão acesso aos Documentos que você selecionou – todo o resto na sua área de trabalho permanece privado.

Você pode criar, revisar e gerenciar todas as suas conexões de API em **Configurações do Craft → API**

<img src="https://mintcdn.com/craft-support/bXGV3J9qfsAQZqJz/images/integrate/api/en/content/api-settings.png?s=a581d87e3a5d721049c4feaf776146b1" alt="Gerenciamento da conexão API em Configurações" width="800" height="486" data-path="images/integrate/api/en/content/api-settings.png" />

Depois de criar uma API Connection no Craft, copie o API endpoint e as credenciais mostradas na Imagine tab.

Em seguida, leve essas informações para o app externo ou fluxo de trabalho que você quer conectar (por exemplo, um Assistente de IA, uma ferramenta de automação ou um ambiente de desenvolvedor) e cole-as nas configurações do conector ou integração de API. Cada ferramenta lida com isso de maneira um pouco diferente, mas a ideia é a mesma: você cola os dados da Craft API lá, e a ferramenta passa a acessar apenas os Documentos selecionados para essa conexão.

<Info title="Acesso à API em nível de Espaço (v3.3.5+)">
  A Craft API agora oferece **acesso completo em nível de Espaço** com capacidades avançadas:

  * **Pesquisar por todos os Documentos** com filtros por Pastas, Tags e data
  * **Notas Diárias e Tarefas** totalmente acessíveis via API
  * **Criar, atualizar e excluir** Documentos programaticamente
  * **Gerenciamento de Coleções** incluindo criação e edição de schema
  * **Busca avançada** com suporte a regex e filtros de data sensíveis ao fuso horário

  Consulte a [documentação oficial da API](https://www.craft.do/imagine/) para detalhes completos dos endpoints.
</Info>

## Casos de uso

Abaixo estão alguns exemplos do que você pode construir com a API:

* Um painel pessoal que atualiza automaticamente
* Uma lista de tarefas que sincroniza com outro app de produtividade
* Um registro de leitura que busca dados de uma fonte externa
* Um assistente personalizado com IA feito sob medida para os seus Documentos do Craft
* Criação automática de Documentos a partir de modelos
* Backups ou exportações programadas
* Integração com ferramentas de comunicação da equipe

As possibilidades são amplas - a API permite estender o Craft do jeito que você imaginar.

## Guias completos e documentação

Todos os guias passo a passo para a API, conexões MCP e integrações de exemplo (incluindo Claude e ChatGPT) estão disponíveis aqui:

👉 [**https://www.craft.do/imagine/**](https://www.craft.do/imagine/)

Esse é o melhor lugar para explorar tutoriais, aprender como ativar o MCP e entender como conectar o Craft a ferramentas de terceiros.

Se você precisar de ajuda para começar ou tiver perguntas, fique à vontade para entrar em contato conosco - estamos aqui para ajudar.
