Skip to main content
PUT
Replace a database's rows

Authorizations

Authorization
string
header
required

Secret API key, created in the dashboard under Settings → API. Send it as Authorization: Bearer rk_secret_… from your server only. Publishable keys (pk_live_…) are for the native SDKs and reach the capture endpoints alone. An unknown key returns 401.

Path Parameters

id
string
required

Database id — stable across re-uploads.

Pattern: ^[A-Za-z0-9_-]{1,64}$
Example:

"db_01hz3k9m2q"

Body

application/json
name
string
required
Required string length: 1 - 80
columns
string[]
required
Required array length: 1 - 60 elements
Required string length: 1 - 80
rows
string[][]
required
Maximum array length: 5000
Maximum string length: 4096
identifier_column
string
Required string length: 1 - 80
source
enum<string>
default:csv
Available options:
csv

Response

Table replaced — same id, same created_at, fresh updated_at.

id
string
required
Pattern: ^[A-Za-z0-9_-]{1,64}$
name
string
required
Required string length: 1 - 80
columns
string[]
required
rows
string[][]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
source
enum<string>
required
Available options:
csv
identifier_column
string