API Reference

Builda provides REST and GraphQL APIs for developer integrations, custom frontends, and automation.

Base URL

https://{your-company}-api.builda.io/api/v1/

API	Endpoint	Use Case
REST	`/api/v1/*`	CRUD operations, standard integrations
GraphQL	`/graphql`	Flexible queries, custom frontend data needs

All API requests require a Bearer token (Laravel Sanctum). See Authentication.

All REST responses follow a standardised JSON envelope:

{
  "success": true,
  "data": { ... },
  "message": "Success"
}

Error responses:

{
  "success": false,
  "message": "Error description",
  "errors": { ... }
}

API requests are rate-limited. Contact the Builda team if you need higher limits for your use case.

Guide	What You'll Learn
Authentication	Getting and using API tokens
REST API	Available endpoints, filtering, pagination
GraphQL	Schema, queries, mutations
Errors	Error codes and troubleshooting