# Budibase Public API

**Canonical:** https://apis.io/apis/budibase/budibase-public-api/  
**Provider:** Budibase — https://apis.io/providers/budibase/  
**Base URL:** https://budibase.app/api/public/v1  
**Documentation:** https://docs.budibase.com/docs/public-api

Budibase Public API is one of 6 APIs that [Budibase](https://apis.io/providers/budibase/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Application, Tables, Rows, User, and Query. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The complete Budibase Public API as Budibase itself publishes it — OpenAPI 3.1.0, info.version 3.3.0, 44 operations across workspaces, applications, tables, rows, views, users, roles, queries and metrics. Harvested verbatim on 2026-09-04 from packages/server/specs/openapi.yaml in the Budibase monorepo, the location Budibase's own Public API documentation directs integrators to. Supersedes the five per-tag splits below in coverage: those describe 26 operations and omit workspaces, views, roles and metrics entirely.

## Operations (44)

| Method | Path | Summary |
|---|---|---|
| POST | `/applications` | Create an application |
| PUT | `/applications/{appId}` | Update an application |
| DELETE | `/applications/{appId}` | Delete an application |
| GET | `/applications/{appId}` | Retrieve an application |
| POST | `/applications/{appId}/unpublish` | Unpublish an application |
| POST | `/applications/{appId}/publish` | Publish an application |
| POST | `/applications/{appId}/import` | Import an app to an existing app 🔒 |
| POST | `/applications/{appId}/export` | Export an app 🔒 |
| POST | `/applications/search` | Search for applications |
| GET | `/metrics` | Retrieve Budibase tenant metrics |
| POST | `/queries/{queryId}` | Execute a query |
| POST | `/queries/search` | Search for queries |
| POST | `/roles/assign` | Assign a role to a list of users |
| POST | `/roles/unassign` | Un-assign a role from a list of users |
| POST | `/tables/{tableId}/rows` | Create a row |
| PUT | `/tables/{tableId}/rows/{rowId}` | Update a row |
| DELETE | `/tables/{tableId}/rows/{rowId}` | Delete a row |
| GET | `/tables/{tableId}/rows/{rowId}` | Retrieve a row |
| POST | `/tables/{tableId}/rows/search` | Search for rows |
| POST | `/views/{viewId}/rows/search` | Search for rows in a view |
| POST | `/tables` | Create a table |
| PUT | `/tables/{tableId}` | Update a table |
| DELETE | `/tables/{tableId}` | Delete a table |
| GET | `/tables/{tableId}` | Retrieve a table |
| POST | `/tables/search` | Search for tables |
| POST | `/users` | Create a user |
| PUT | `/users/{userId}` | Update a user |
| DELETE | `/users/{userId}` | Delete a user |
| GET | `/users/{userId}` | Retrieve a user |
| POST | `/users/search` | Search for users |
| POST | `/views` | Create a view |
| PUT | `/views/{viewId}` | Update a view |
| DELETE | `/views/{viewId}` | Delete a view |
| GET | `/views/{viewId}` | Retrieve a view |
| POST | `/views/search` | Search for views |
| POST | `/workspaces` | Create a workspace |
| PUT | `/workspaces/{workspaceId}` | Update a workspace |
| DELETE | `/workspaces/{workspaceId}` | Delete a workspace |
| GET | `/workspaces/{workspaceId}` | Retrieve a workspace |
| POST | `/workspaces/{workspaceId}/publish` | Publish a workspace |
| POST | `/workspaces/{workspaceId}/unpublish` | Unpublish a workspace |
| POST | `/workspaces/{workspaceId}/import` | Import a workspace to an existing workspace 🔒 |
| POST | `/workspaces/{workspaceId}/export` | Export a workspace 🔒 |
| POST | `/workspaces/search` | Search for workspaces |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/openapi/budibase-public-api-openapi.yml
- **Documentation** — https://docs.budibase.com/docs/public-api
- **APIReference** — https://docs.budibase.com/reference
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/authentication/budibase-authentication.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/overlays/budibase-public-api-overlay.yaml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/errors/budibase-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/data-model/budibase-data-model.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/conventions/budibase-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/budibase/refs/heads/main/rate-limits/budibase-rate-limits.yml

## Other Budibase APIs (5)

- [Budibase Applications API](https://apis.io/apis/budibase/budibase-applications-api/)
- [Budibase Queries API](https://apis.io/apis/budibase/budibase-queries-api/)
- [Budibase Rows API](https://apis.io/apis/budibase/budibase-rows-api/)
- [Budibase Tables API](https://apis.io/apis/budibase/budibase-tables-api/)
- [Budibase Users API](https://apis.io/apis/budibase/budibase-users-api/)

## Tags

Application, Tables, Rows, User, Query

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/budibase/budibase-public-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/budibase/.