These are the API docs for https://www.contibase.com.
Contibase combines email, tables, storage, pages, and server functions behind one API.
If you are using Contibase for email, start with email address management, single mail, bulk mail, and mail query endpoints.
The endpoints described here build off that base URL. For example:
https://www.contibase.com/api/v1/tables/{table_id}/bulk_rows
You should place an authorized `CONTIBASE_ACCESS_TOKEN` in request headers as an Auth Bearer. Access Tokens can be user generated at https://www.contibase.com/settings in the Auth tab.
Security Note:
When calling these APIs, always call them from a secure environment, such as your server.
Store your `CONTIBASE_ACCESS_TOKEN` in a private `.env` variable.
If your `CONTIBASE_ACCESS_TOKEN` is leaked, others may gain access to your account and perform harmful operations.
We use snake_case and encourage you to help keep integrations consistent with our docs. Below is an example of calling an endpoint in JavaScript:
async function create_bulk_table_rows(table_id, rows) {
try {
const create_bulk_table_rows_res = await fetch(`/api/v1/tables/${table_id}/bulk_rows`, {
method: 'POST',
headers: {
"authorization": `Bearer ${CONTIBASE_ACCESS_TOKEN}`,
"content-type": "application/json"
},
body: JSON.stringify({ rows: rows })
})
const create_bulk_table_rows_res_body = await create_bulk_table_rows_res.json()
if (!create_bulk_table_rows_res.ok) {
throw new Error(create_bulk_table_rows_res_body?.message ?? 'Error creating bulk table rows.')
}
console.log('successfully created bulk rows', create_bulk_table_rows_res_body)
} catch (err) {
console.log('Error creating bulk table rows', err)
}
}Some endpoints use form data for the request body and may look something like:
async function ai_remove_image_background(image_url) {
try {
const form_data = new FormData();
const rand_name = Math.random().toString(26).slice(2);
const res = await fetch(image_url);
const blob = await res.blob();
form_data.append("file", blob, rand_name);
const response = await fetch("/api/v1/tools/remove_background", {
method: "POST",
body: form_data
});
const res_body = await response.json();
if (!response.ok) {
throw new Error(res_body?.message ?? "Error removing image background.");
}
console.log("Successfully removed image background", res_body);
} catch (err) {
console.log("Error removing image background", err);
}
}delete account (initializes cleanup)
delete/api/v1/accounts/[account_id]
account_idstring (path parameter)
gets account profile for the account_id
get/api/v1/accounts/[account_id]
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/access_tokens
account_idstring (path parameter)
jsonsee endpoint details
endpoint
post/api/v1/accounts/[account_id]/access_tokens
account_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/billing/subscriptions
account_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/bio
account_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/color
account_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/domains
account_idstring (path parameter)
endpoint
delete/api/v1/accounts/[account_id]/domains/[domain_id]
domain_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/config
domain_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/dns
domain_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/dns/[record_id]
record_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/info
domain_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/[domain_id]/main
domain_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/remove
domain_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/[domain_id]/subdomain
domain_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/domains/[domain_id]/transfer_info
domain_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/[domain_id]/verify_dkim
domain_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/[domain_id]/verify_inbound
domain_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/[domain_id]/verify_return_path
domain_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/availability
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/purchase
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/domains/transfer
account_idstring (path parameter)
endpoint
post/api/v1/accounts/[account_id]/domains/verify_ownership
account_idstring (path parameter)
jsonsee endpoint details
List the email addresses configured for the account.
get/api/v1/accounts/[account_id]/email_addresses
account_idstring (path parameter)
jsonsee endpoint details
Create an email address on a domain owned by the account.
post/api/v1/accounts/[account_id]/email_addresses
account_idstring (path parameter)
jsonsee endpoint details
Remove an email address from the account.
delete/api/v1/accounts/[account_id]/email_addresses/[email_id]
email_idstring (path parameter)
jsonsee endpoint details
Update an email address display name or note.
put/api/v1/accounts/[account_id]/email_addresses/[email_id]
email_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/functions
account_idstring (path parameter)
jsonsee endpoint details
endpoint
post/api/v1/accounts/[account_id]/functions
account_idstring (path parameter)
jsonsee endpoint details
endpoint
delete/api/v1/accounts/[account_id]/functions/[function_id]
function_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/functions/[function_id]
function_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/functions/[function_id]
function_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/functions/[function_id]/crons
function_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/functions/[function_id]/description
function_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/functions/[function_id]/name
function_idstring (path parameter)
jsonsee endpoint details
endpoint
post/api/v1/accounts/[account_id]/functions/[function_id]/run
function_idstring (path parameter)
jsonsee endpoint details
endpoint
post/api/v1/functions/generate
overall_promptstring (path parameter)
existing_functionstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/icon
account_idstring (path parameter)
Note: This endpoint should use formData() for the request body
form_datasee endpoint details
endpoint
put/api/v1/accounts/[account_id]/icon
account_idstring (path parameter)
Note: This endpoint should use formData() for the request body
form_datasee endpoint details
endpoint
get/api/v1/accounts/[account_id]/logo
account_idstring (path parameter)
Note: This endpoint should use formData() for the request body
form_datasee endpoint details
endpoint
put/api/v1/accounts/[account_id]/logo
account_idstring (path parameter)
Note: This endpoint should use formData() for the request body
form_datasee endpoint details
Get a single email transaction with message details and references.
get/api/v1/accounts/[account_id]/mail/[email_transaction_id]
email_transaction_idstring (path parameter)
Update tags, read state, or note for an email transaction.
put/api/v1/accounts/[account_id]/mail/[email_transaction_id]/extra
email_transaction_idstring (path parameter)
jsonsee endpoint details
Send a bulk email to users matching a tag.
post/api/v1/accounts/[account_id]/mail/bulk
account_idstring (path parameter)
jsonsee endpoint details
Delete a bulk send group.
delete/api/v1/accounts/[account_id]/mail/bulk/[bulk_send_group_id]
bulk_send_group_idstring (path parameter)
Query account mail with filters for address, time, status, tags, and tracking fields.
get/api/v1/accounts/[account_id]/mail/q
account_idstring (path parameter)
Send one email transaction from an account email address.
post/api/v1/accounts/[account_id]/mail/single
account_idstring (path parameter)
jsonsee endpoint details
Create, update, or delete account-level mail tags.
put/api/v1/accounts/[account_id]/mail/tags
account_idstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/accounts/[account_id]/name
account_idstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/accounts/[account_id]/pages
account_idstring (path parameter)
limitstring
offsetstring
qstring
endpoint
get/api/v1/accounts/[account_id]/passkeys
account_idstring (path parameter)
endpoint
delete/api/v1/accounts/[account_id]/passkeys/[passkey_id]
passkey_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/settings
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/storage
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/tables
account_idstring (path parameter)
endpoint
get/api/v1/accounts/[account_id]/user_table
account_idstring (path parameter)
qstring
handles chat interactions with openai tools
post/api/v1/chat_assistant
input_contentarray of {type:'text'|'images', text?:string, images?:[{url}] }
previous_message_idstring (optional)
storage_patharray (optional, default ['chat'])
assistant to generate sveltekit-ui example code
post/api/v1/code_generator
jsonsee endpoint details
endpoint
get/api/v1/docs
endpoint
get/api/v1/gifs/search
bundlestring
langstring
limitstring
offsetstring
qstring
ratingstring
endpoint
get/api/v1/gifs/trending
bundlestring
limitstring
offsetstring
ratingstring
apple maps place retrieve by place_id
post/api/v1/maps/retrieve
tokenstring (mapkit)
place_idstring
apple maps search
post/api/v1/maps/search
tokenstring (mapkit)
search_valstring
apple maps suggest (autocomplete)
post/api/v1/maps/suggest
tokenstring (mapkit)
search_valstring
get apple mapkit access token
get/api/v1/maps/token
endpoint
post/api/v1/pages
jsonsee endpoint details
endpoint
delete/api/v1/pages/[page_id_or_full_path]
page_id_or_full_pathstring (path parameter)
jsonsee endpoint details
endpoint
get/api/v1/pages/[page_id_or_full_path]
page_id_or_full_pathstring (path parameter)
jsonsee endpoint details
endpoint
put/api/v1/pages/[page_id_or_full_path]
page_id_or_full_pathstring (path parameter)
jsonsee endpoint details
endpoint
post/api/v1/pages/autogenerate
jsonsee endpoint details
uploads a file to storage and creates a db record
post/api/v1/storage
Note: This endpoint should use formData() for the request body
account_idstring
overwrite_storage_idstring (optional)
filebinary file (<=8mb)
folder_patharray (optional)
metadataobject (optional)
is_temporarybool (optional)
is_publicbool (optional)
endpoint
delete/api/v1/storage/[storage_id]
storage_idstring (path parameter)
typestring
redirects to a signed url for the requested storage item
get/api/v1/storage/[storage_id]
storage_idstring (path parameter)
typestring
endpoint
put/api/v1/storage/[storage_id]/settings
storage_idstring (path parameter)
jsonsee endpoint details
bulk delete storage items by id
delete/api/v1/storage/bulk
storage_idsarray of string ids
endpoint
delete/api/v1/storage/delete_temporary
endpoint
get/api/v1/storage/structure/[storage_id_or_full_path]
storage_id_or_full_pathstring (path parameter)
fetches multiple storage items by path (use __ delimiter)
get/api/v1/storage/structure/bulk/[full_path]
full_pathstring (path parameter)
creates a new table
post/api/v1/tables
account_idstring
namestring
descriptionstring (optional)
endpoint
delete/api/v1/tables/[table_id]
gets table rows and metadata
get/api/v1/tables/[table_id]
table_idstring (path parameter)
filtersquery param (optional, json string). supports: {"and":[{field,operator,value},...]} with operators eq, lt, gt, lte, gte, like; combine via and/or. example: const filters_obj = { and: [ { field: 'month', operator: 'eq', value: month_number }, { field: 'day_of_month', operator: 'eq', value: day_number } ] }
limitint e.g. 1000
offsetint e.g. 10
qstring
bulk create or delete rows for a table
delete/api/v1/tables/[table_id]/bulk_rows
table_idstring (path parameter)
row_idsarray of string ids
bulk create or delete rows for a table
post/api/v1/tables/[table_id]/bulk_rows
table_idstring (path parameter)
rowsarray of row objects
creates a new table column. body_content docs below cover the simple render types (text/number/time/color).
post/api/v1/tables/[table_id]/columns
table_idstring (path parameter)
column{"key":"string. like 'planet'","description":"string|null (optional)","display_order":"number (optional)","is_db_column":"bool (required)","postgres_type":"string (required). example 'text' | 'int' | 'jsonb' | 'text[]'","db_data_type":{"type":"string (required). example 'text_literal' | 'int_literal' | 'object_literal' | ...","attributes":"object (optional)","items":"object (optional, for arrays)","properties":"object (optional, for objects)"},"is_nullable":"bool (optional, default true)","default_value":"any|null (optional)","is_primary_key":"bool (optional, default false)","is_autogenerated":"bool (optional, default false)","is_force_uniqueness":"bool (optional, default false)","is_updatable":"bool (optional, default true)","is_shown":"bool (optional, default true)","is_fixed":"bool (optional, default false)","alignment":"string (optional, default 'left')","min_width":"number (optional)","max_width":"number (optional)","is_use_in_short_display":"bool (optional, default false)","header_content":{"type_id":"string (required). usually 'base_text'","children":"array (optional)","attributes":{"content":"string (optional). header label"},"selector_id":"string (optional)"},"body_content":{"one_of":"base_text | number | time | color","options":{"base_text":{"type_id":"base_text","children":[],"attributes":{"size":"number (optional, default 10)","content_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'title']"}},"number":{"type_id":"number","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'population']"}},"time":{"type_id":"time","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'db_epoch_created']","format":"string (optional). example 'epoch' | 'time_full'","display_format":"string (optional). example 'calendar_date'","text_color":"string|null (optional)"}},"color":{"type_id":"color","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'color']","size":"number (optional, default 3)","border_radius":"number (optional, default 0.5)","is_show_details":"bool|null (optional)"}}}}}
endpoint
delete/api/v1/tables/[table_id]/columns/[column_id]
table_idstring (path parameter)
column_idstring (path parameter)
jsonsee endpoint details
updates a table column. supports partial updates (recommended) or full column object.
put/api/v1/tables/[table_id]/columns/[column_id]
table_idstring (path parameter)
column_idstring (path parameter)
column{"partial":true,"schema":{"key":"string. like 'planet'","description":"string|null (optional)","display_order":"number (optional)","is_db_column":"bool (required)","postgres_type":"string (required). example 'text' | 'int' | 'jsonb' | 'text[]'","db_data_type":{"type":"string (required). example 'text_literal' | 'int_literal' | 'object_literal' | ...","attributes":"object (optional)","items":"object (optional, for arrays)","properties":"object (optional, for objects)"},"is_nullable":"bool (optional, default true)","default_value":"any|null (optional)","is_primary_key":"bool (optional, default false)","is_autogenerated":"bool (optional, default false)","is_force_uniqueness":"bool (optional, default false)","is_updatable":"bool (optional, default true)","is_shown":"bool (optional, default true)","is_fixed":"bool (optional, default false)","alignment":"string (optional, default 'left')","min_width":"number (optional)","max_width":"number (optional)","is_use_in_short_display":"bool (optional, default false)","header_content":{"type_id":"string (required). usually 'base_text'","children":"array (optional)","attributes":{"content":"string (optional). header label"},"selector_id":"string (optional)"},"body_content":{"one_of":"base_text | number | time | color","options":{"base_text":{"type_id":"base_text","children":[],"attributes":{"size":"number (optional, default 10)","content_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'title']"}},"number":{"type_id":"number","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'population']"}},"time":{"type_id":"time","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'db_epoch_created']","format":"string (optional). example 'epoch' | 'time_full'","display_format":"string (optional). example 'calendar_date'","text_color":"string|null (optional)"}},"color":{"type_id":"color","children":[],"attributes":{"val_from_variable_path":"array (recommended). example ['variables','rows',['row_i'],'color']","size":"number (optional, default 3)","border_radius":"number (optional, default 0.5)","is_show_details":"bool|null (optional)"}}}}}}
updates a table's description
put/api/v1/tables/[table_id]/description
table_idstring (path parameter)
table_descriptionstring
updates a table's function triggers
put/api/v1/tables/[table_id]/function_triggers
table_idstring (path parameter)
function_triggersarray of {trigger_event_type, function_to_call_id, is_enabled}
updates a table's name
put/api/v1/tables/[table_id]/name
table_idstring (path parameter)
table_namestring
inserts a single row into a specified table
post/api/v1/tables/[table_id]/rows
table_idstring (path parameter)
row_dataobject of field values
deletes a single row by row_id in a specified table
delete/api/v1/tables/[table_id]/rows/[row_id]
row_idstring (path parameter)
jsonsee endpoint details
retrieves a single row by row_id for a specified table
get/api/v1/tables/[table_id]/rows/[row_id]
row_idstring (path parameter)
jsonsee endpoint details
updates row data in a specified table
put/api/v1/tables/[table_id]/rows/[row_id]
row_idstring (path parameter)
row_dataobject of updated field values
updates a table's default sort
put/api/v1/tables/[table_id]/sort
table_idstring (path parameter)
inputarray of {variable_path, is_ascending}
builds audio and saves to storage
post/api/v1/tools/audio
Note: This endpoint should use formData() for the request body
account_idstring
is_text_to_audiobool
text_to_audio_inputstring (optional)
audiobinary audio file (optional)
voice_idstring (optional)
tagsjson (optional)
imagebinary image file (optional)
folder_pathstring or array (optional)
reads id3 tags from an audio file
post/api/v1/tools/audio/read_tags
Note: This endpoint should use formData() for the request body
filebinary audio file
generates an image using openai dall-e
post/api/v1/tools/image_generator_original
promptstring (<=4000 chars)
image generation via replicate
post/api/v1/tools/image_generator
Note: This endpoint should use formData() for the request body
text_promptstring (optional)
images_promptarray of image files (optional)
vectorizes an image to svg (recraft vectorize)
post/api/v1/tools/image_to_svg
Note: This endpoint should use formData() for the request body
images_promptarray of image files
is_make_squarebool (optional)
precisionnumber (optional)
removes background from an image using replicate
post/api/v1/tools/remove_background
Note: This endpoint should use formData() for the request body
filebinary image form field (<=2000kb)
restores face details in an image using replicate
post/api/v1/tools/restore_face
Note: This endpoint should use formData() for the request body
filebinary image form field (<=2000kb)
enhances or upsamples an image using replicate api
post/api/v1/tools/restore_resolution
Note: This endpoint should use formData() for the request body
filebinary image form field (<=2000kb)
optimizes svg text with precision and square options
post/api/v1/tools/svg_optimizer
svg_textstring
precisionnumber (optional)
is_make_squarebool (optional)
Reasoning:
Output Type:
No Chat History