API Reference
Run any Buildly tool programmatically from your own application. One endpoint, one key, any tool.
Authentication
All API requests require a Bearer token in the Authorization header. Generate API keys in Settings → API Keys.
Authorization: Bearer bld_your_key_here
Run a tool
/api/v1/tools/{slug}/runReplace {slug}with the tool's URL slug, visible in the tool's URL on Buildly.
Request body
Send a JSON body with an inputobject. The keys match each tool's input field keys, visible on the tool's page.
{
"input": {
"field_key": "value",
"another_field": "value"
}
}Response
A successful response returns HTTP 200 with a resultobject. Keys match the tool's output fields.
{
"result": {
"output_key": "Generated content here..."
}
}Full example
curl -X POST https://buildly.click/api/v1/tools/eli5/run \
-H "Authorization: Bearer bld_your_key_here" \
-H "Content-Type: application/json" \
-d '{"input": {"topic": "How does DNS work?"}}'Error codes
400Bad Request
Missing or invalid input fields.
401Unauthorized
Missing or invalid API key.
403Forbidden
Tool requires Pro plan or a paid purchase.
404Not Found
No tool with that slug exists.
429Rate Limited
Daily API key limit reached. Resets at midnight UTC.
500Server Error
Tool execution failed. Retry with exponential backoff.
Rate limits
Limits reset daily at midnight UTC. Upgrade in Settings → Plan.
Ready to build?
Get your API key