create a table

post https://{databaseId}-{region}.apps.astra.datastax.com/api/rest/v2/schemas/keyspaces/{keyspace-id}/tables

time	status	user agent
Retrieving recent requests…

Loading…

Path Params

databaseId

string

required

UUID of your database from the Astra URL.
For example, d341f349-e5db-46d2-9c90-bb9ebaa6f0fc.

region

string

required

Cloud region where your database lives.
For example, us-east-1

keyspace-id

string

required

keyspace name

Body Params

name

string

required

ifNotExists

boolean

Defaults to false

Determines whether to create a new table if a table with the same name exists. Attempting to create an existing table returns an error unless this option is true.

columnDefinitions

array of objects

required

columnDefinitions*

primaryKey

object

required

Defines a column list for the primary key. Can be either a single column, compound primary key, or composite partition key. Provide multiple columns for the partition key to define a composite partition key.

tableOptions

object

Headers

X-Cassandra-Token

string

required

The token returned from the authorization endpoint. Use this token in each request.

Responses

Language

URL


xxxxxxxxxx
12
1
curl --request POST \
2
     --url https://databaseid-region.apps.astra.datastax.com/api/rest/v2/schemas/keyspaces/keyspace-id/tables \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "ifNotExists": false,
8
  "tableOptions": {
9
    "defaultTimeToLive": 0
10
  }
11
}
12
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

201resource created

400Bad Request

401Unauthorized

409Conflict

500Internal server error