Create a record template for a database
Saves a reusable set of prefilled field values for new records, either from explicit `data` or captured from an existing record via `sourceRecordId` (whose page content is copied too). Requires `databases:write` on the database. Rejected when the label or description exceeds its length limit or when the template data exceeds 1 MB; a label already in use fails unless `onLabelConflict` is `increment`.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/workspaces/string/databases/string/record-templates" \ -H "Content-Type: application/json" \ -d '{ "label": "string" }'{ "data": { "id": "string", "workspaceId": "string", "databaseId": "string", "label": "string", "description": "string", "data": {}, "contentSurfaceId": "string", "isDefault": true, "createdAt": "string", "updatedAt": "string" }}{ "_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}List the record templates of a database
Returns the database's record templates ordered by label, including their prefilled field data, linked content surface, and which one is the default for new records. Requires `databases:read` on the database.
Update a record template
Changes a record template's label, description, prefilled `data`, or default flag, validating the data against the database's current fields. Requires `databases:write` on the database. An unknown template returns not-found, and the same label, description, and 1 MB data limits as creation apply.