Create (beta)

Create a new Dune table with the specified name and namespace.

This endpoint is currently in beta, and may change without warning.

The resulting table will be empty, and can be inserted into with the /insert endpoint.

• A table must currently be created as public. If the request tries to create a private table, it will fail.
• If a table already exists with the same name, the request will fail.
• Column names in the table can’t start with a special character or a digit.
• To delete a table, you must go to user settings (dune.com) -> data -> delete.
• Creating a table does not incur credits.

Authorizations

x-dune-api-key

string

headerrequired

The API key of your team or user.

Path Parameters

namespace

string

required

The namespace of the table to create. Must be the name of your associated API key, i.e. either my_user or my_team.

table_name

string

required

The name of the table to create. Must begin with dataset_ and contain only lowercase letters, digits, and underscores.

Body

application/json

schema

object[]

required

An ordered list of columns that define the table schema. Cannot be empty.

Show child attributes

is_private

boolean

default: false

If true, the table will be private. This is not supported yet, it has to be false. If private it is only visible to the team or user that your API key is associated with.

description

string

A description of the table.

Response

201 - application/json

The response is of type object.