API docs by Redocly

Astra DB Serverless Data API (1.0.5)

Download OpenAPI specification:Download

URL: https://stargate.io License: Apache 2.0 Terms of Service

The Astra DB Serverless Data API modifies and queries data stored as unstructured JSON documents in collections. See the documentation site for additional information.

General

Executes general commands.

Execute command

Executes a single general command.

Authorizations:
Token
Request Body schema: application/json
Any of
name
required
string [ 1 .. 48 ] characters [a-zA-Z][a-zA-Z0-9_]*

Name of the namespace

object (CreateNamespaceCommand.Options)

Options for creating a new namespace.

Responses

Request samples

Content type
application/json
Example
{
  • "createNamespace": {
    }
}

Response samples

Content type
application/json
Example
{
  • "status": {
    }
}

Namespaces

Executes namespace commands.

Execute command

Executes a single command against a collection.

Authorizations:
Token
path Parameters
namespace
required
string <= 48 characters [a-zA-Z][a-zA-Z0-9_]*
Example: cycling

The namespace where the collection is located.

Request Body schema: application/json
Any of
name
required
string [ 1 .. 48 ] characters [a-zA-Z][a-zA-Z0-9_]*

Name of the collection

object

Configuration options for the collection

Responses

Request samples

Content type
application/json
Example
{
  • "createCollection": {
    }
}

Response samples

Content type
application/json
Example
{
  • "status": {
    }
}

Documents

Executes document commands against a single collection.

Execute command

Executes a single command against a collection.

Authorizations:
Token
path Parameters
namespace
required
string <= 48 characters [a-zA-Z][a-zA-Z0-9_]*
Example: cycling

The namespace where the collection is located.

collection
required
string <= 48 characters [a-zA-Z][a-zA-Z0-9_]*
Example: events

The name of the collection.

Request Body schema: application/json
Any of
object (JsonNode)
object (FilterClause)

Responses

Request samples

Content type
application/json
Example
{
  • "countDocuments": {
    }
}

Response samples

Content type
application/json
Example
{
  • "status": {
    }
}