Getting Started
Create your first scene in 3 minutes
Want to explore your workspace? Here's how to make your first API requests in 3 steps:
1. Get Your API Key
Navigate to your workspace settings in Excalidraw Plus and create an API key with the permissions you need.
Your API key will be visible only once—copy it somewhere safe! Learn more about API key management.
2. List Your Collections
Start by fetching your collections using curl:
curl https://api.excalidraw.com/api/v1/collections \
-H "Authorization: Bearer YOUR_API_KEY"Or with JavaScript:
const response = await fetch("https://api.excalidraw.com/api/v1/collections", {
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
});
const collections = await response.json();
console.log("Your collections:", collections);3. List Scenes in a Collection
Now use a collection ID from the previous response to fetch its scenes:
curl https://api.excalidraw.com/api/v1/collections/COLLECTION_ID/scenes \
-H "Authorization: Bearer YOUR_API_KEY"Or with JavaScript:
const collectionId = collections.data[0].id; // Use first collection
const response = await fetch(
`https://api.excalidraw.com/api/v1/collections/${collectionId}/scenes`,
{
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
},
);
const scenes = await response.json();
console.log("Scenes in collection:", scenes);Next Steps
You've made your first API requests! Now explore more capabilities:
- Authentication - Learn about API key permissions and security
- Pagination - Handle large result sets efficiently
- Rate Limiting - Stay within usage limits
- Endpoint Documentation - Check the detailed docs below for all available operations
