List the records in a database
Returns records with their hydrated cell values, linked-record titles and computed fields. Pass `search` for a ranked full-text match over record content and `limit` to cap the response, which is clamped to between 1 and 100; without `limit` every record is returned in creation order. Requires the `records:read` permission on the database.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/databases/string/records"{ "data": [ { "id": "1d8a44e0-7c93-4f21-b60a-3e8d2f5a9c14", "workspaceId": "4b81aa0c-6d2f-4b19-9f0e-1a7c3d5e8b02", "databaseId": "9f2c1e7a-3b58-4d0c-8e27-6a1f9d4b3c85", "contentSurfaceId": "string", "title": "Ship the desktop app", "data": { "status": "in_progress", "due": "2026-08-01" }, "relations": {}, "computed": {}, "system": {}, "related": {}, "archived": false, "externalId": "string", "createdByUserId": "string", "updatedByUserId": "string", "createdAt": "2026-07-10T08:00:00.000Z", "updatedAt": "2026-07-14T11:26:02.000Z" } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Preview what deleting a field would affect
Returns the views, formulas, rollups, buttons and other references that depend on the field, with an overall status saying whether deletion is safe, needs confirmation, or is blocked. Read-only. Requires the `databases:write` permission.
Create a record in a database
Creates a record from the given title and cell data, optionally with a caller-minted `id` and content-surface id so an optimistic client keeps the same identity after the write lands. Requires the `records:write` permission and counts against the workspace's record allowance. The write is refused when a value does not fit its field or a blocking validation rule on the database fails.