Endpoint Migration Guide

The table endpoints have been migrated from /v1/table/* to /v1/uploads/* for better discoverability and consistency. The old endpoints are deprecated but remain functional for backward compatibility.

Deprecated endpoints will be removed in a future version. Please migrate to the new endpoints as soon as possible.

Endpoint Mapping

Old Endpoint (Deprecated)	New Endpoint
`POST /v1/table/create`	`POST /v1/uploads`
`POST /v1/table/:namespace/:table_name/insert`	`POST /v1/uploads/:namespace/:table_name/insert`
`POST /v1/table/upload/csv`	`POST /v1/uploads/csv`
`POST /v1/table/:namespace/:table_name/clear`	`POST /v1/uploads/:namespace/:table_name/clear`
`DELETE /v1/table/:namespace/:table_name`	`DELETE /v1/uploads/:namespace/:table_name`
`GET /v1/tables`	`GET /v1/uploads`

What Changed?

URL Structure

All table management endpoints now use the /v1/uploads base path instead of /v1/table or /v1/tables. This change makes it clearer that these endpoints are specifically for managing uploaded tables.

Migration Examples

Create Table

Before:

curl -X POST "https://api.dune.com/api/v1/table/create" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": "my_user",
    "table_name": "interest_rates",
    "schema": [
      {"name": "date", "type": "timestamp"},
      {"name": "rate", "type": "double"}
    ]
  }'

After:

curl -X POST "https://api.dune.com/api/v1/uploads" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "namespace": "my_user",
    "table_name": "interest_rates",
    "schema": [
      {"name": "date", "type": "timestamp"},
      {"name": "rate", "type": "double"}
    ]
  }'

Insert Data

Before:

curl -X POST "https://api.dune.com/api/v1/table/my_user/interest_rates/insert" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: text/csv" \
  --upload-file data.csv

After:

curl -X POST "https://api.dune.com/api/v1/uploads/my_user/interest_rates/insert" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: text/csv" \
  --upload-file data.csv

Upload CSV

Before:

curl -X POST "https://api.dune.com/api/v1/table/upload/csv" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "table_name": "my_table",
    "data": "col1,col2\nval1,val2",
    "is_private": false
  }'

After:

curl -X POST "https://api.dune.com/api/v1/uploads/csv" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "table_name": "my_table",
    "data": "col1,col2\nval1,val2",
    "is_private": false
  }'

Clear Table

Before:

curl -X POST "https://api.dune.com/api/v1/table/my_user/interest_rates/clear" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

After:

curl -X POST "https://api.dune.com/api/v1/uploads/my_user/interest_rates/clear" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

Delete Table

Before:

curl -X DELETE "https://api.dune.com/api/v1/table/my_user/interest_rates" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

After:

curl -X DELETE "https://api.dune.com/api/v1/uploads/my_user/interest_rates" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

List Tables

Before:

curl -X GET "https://api.dune.com/api/v1/tables?limit=10&offset=0" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

After:

curl -X GET "https://api.dune.com/api/v1/uploads?limit=10&offset=0" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY"

SDK Support

Python SDK

The Dune Python SDK will be updated to support the new endpoints. Check the Python SDK documentation for the latest version and migration guidance.

TypeScript SDK

The Dune TypeScript SDK will be updated to support the new endpoints. Check the TypeScript SDK documentation for the latest version and migration guidance.

Backward Compatibility

All deprecated endpoints continue to function and will remain available for a transition period. However, we strongly recommend migrating to the new endpoints to ensure compatibility with future versions of the API.

Timeline

Backend Migration: ✅ Complete
Documentation Migration: ✅ Complete
Deprecation Period: 3 months (until March 1, 2026)
Old Endpoint Removal: March 1, 2026

Need Help?

If you encounter any issues during migration, please:

Check the current endpoint documentation
Review the API reference overview
Contact Dune support

Introduction

Quick Start

Executions and Results

Query Management

Data Uploads

Datasets

Contract Decoding

Materialized Views

Pipelines

Account Management

Post-processing

Webhooks

Client SDKs

Resources

Migration Guide

Endpoint Migration Guide

Endpoint Mapping

What Changed?

URL Structure

Migration Examples

Create Table

Insert Data

Upload CSV

Clear Table

Delete Table

List Tables

SDK Support

Python SDK

TypeScript SDK

Backward Compatibility

Timeline

Need Help?

​Endpoint Migration Guide

​Endpoint Mapping

​What Changed?

​URL Structure

​Migration Examples

​Create Table

​Insert Data

​Upload CSV

​Clear Table

​Delete Table

​List Tables

​SDK Support

​Python SDK

​TypeScript SDK

​Backward Compatibility

​Timeline

​Need Help?

Endpoint Migration Guide

Endpoint Mapping

What Changed?

URL Structure

Migration Examples

Create Table

Insert Data

Upload CSV

Clear Table

Delete Table

List Tables

SDK Support

Python SDK

TypeScript SDK

Backward Compatibility

Timeline

Need Help?