Skip to main content

​
Introduction

The Zite DB API lets you access and manage your Zite databases programmatically, without using the Zite interface. You can create databases, manage table schemas, define field types, and perform CRUD operations on records via the API.

​
Field types

Zite DB supports over 20 different field types to handle various data structures - from simple text and numbers to complex relationships. See the complete Field Types guide for details.

​
Authentication

Generate and view your API key in the Developer settings tab of your account. You can revoke or regenerate your API key at any time via the dashboard.
Screenshot of the Developer tab of a form
To authenticate your requests, you need to provide your API key in the Authorization header in the following format: 
Authorization: Bearer <your-api-key>
Replace <your-api-key> with the API key obtained from your Fillout account. You can obtain your API base URL in the API dashboard. Typically, it will be https://api.fillout.com.
Important: If you’re self-hosting Fillout or using the EU agent, a different URL will appear in the dashboard.
Note: The same API key used for Fillout forms also works with Zite DB endpoints.

​
Finding Database and Table IDs

When working with the Zite Database API, you’ll need to provide database IDs and table IDs in your API requests. Here’s how to find them:
1

Open your database

Click the database from the home page dashboard.
2

Get IDs from the URL

Look at the URL in your browser. It follows this format:
build.fillout.com/database/{databaseId}/{tableId}/...
For example, in this URL:
build.fillout.com/database/67ef4d500c50cce9/t7nUTgYUjzF/vkuDPV6ZqBb
  • Database ID: 67ef4d500c50cce9
  • Table ID: t7nUTgYUjzF
Important: If you’re accessing a database from within a Zite app, make sure to open the database separately and use that URL, not the Zite editor URL itself.

​
Rate limits

All endpoints are limited to being called no more than 50 times per second, per Account/API key. Contact support@fillout.com if you need increased rate limits.

​
Error handling

All API errors return a consistent response format: 
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message"
  }
}

​
Common error codes

CodeDescription
INVALID_RECORD_IDRecord ID is not in valid UUID format
NOT_FOUNDRequested resource does not exist
BAD_REQUESTInvalid request data or validation failure
UNAUTHORIZEDInvalid or missing API key
INTERNAL_SERVER_ERRORServer-side error occurred
NOT_IMPLEMENTEDFeature not yet implemented

​
API Endpoints

Explore all available endpoints organized by functionality:

Records

Create, read, update, and delete records in your tables

Fields

Manage table fields and their configurations

Tables

Create and manage database tables

Databases

Create and manage your databases

​
Records

Manage individual records within your database tables:

Create Record

Add new records to a table with field data

Get Record by ID

Retrieve a specific record by its unique identifier

Update Record

Modify existing record data

List Records

Get all records from a table with filtering options

Delete Record

Remove a record from the database

​
Fields

Configure and manage table field schemas:

Create Field

Add new fields to existing tables

Update Field

Modify field properties and configurations

Delete Field

Remove fields from tables

Field Types Reference

Complete guide to all supported field types

​
Tables

Create and manage database table structures:

Create Table

Create new tables with custom schemas

Update Table

Modify table properties and settings

Delete Table

Remove tables from your database

​
Databases

Manage your database instances:

Create Database

Create new database instances

Get Databases

List all your databases

Get Database by ID

Retrieve specific database information

Delete Database

Remove database instances

Field Types

Complete reference of all supported field types and their configurations.