Use Craft’s API to Build With Replit

With the API switched on, your Craft docs are ready to power the apps you create. From there, you can jump into Replit and build something new with your doc’s data

Enabling the API for Documents

First, you have to enable the API in order for Craft to setup an API endpoint for your documents. Then, you use the API endpoint URL to connect to the server from Replit.

Step 1

Open the “Imagine” tab

Step 2

Click “Add Your First API Connection”

Step 3

Configure your API connection with a name.

Step 4

Click “Add Document” to select which documents this API connection has access to.

Step 5

The API URL that will be used to interact with your document is now displayed at the top

Step 6

Click the “Download AI Bundle” button. This will download a folder containing the API documentation and the content of your doc.

Using the API in a Replit Prompt

Once the API is enabled for your Craft docs, you can now focus on writing a prompt that Replit will use to generate your project.

In order for Replit to see how to use the API and understand the structure of your document, you attach the AI bundle to your prompt. This bundle is a markdown document that contains the current content of your Craft doc as well as the API documentation.

Step 1

Go to Replit. You can create a new project after logging in to your account. Please note that this step is mandatory as you can't properly attach the bundle without being logged in.

Step 2

Click “Add attachment” in the prompt box and upload the AI bundle you downloaded from Craft.

Step 3

Replit will read the uploaded file and show the preview below the prompt box.

Now you can add a prompt to describe the app you want to build. Here is a very general example that can be used for testing:

Please create a website that visualises the content of my connected Craft docs. You find instructions on how to access this data and its structure in the attached file.