Stargate Document API reference
- 1. Endpoints
- 1.1. Auth
- 1.2. Keyspaces
- 1.3. Namespaces
- 1.3.1. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDelete
- 1.3.2. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathDelete
- 1.3.3. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathGet
- 1.3.4. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathPatch
- 1.3.5. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathPut
- 1.3.6. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdGet
- 1.3.7. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdPatch
- 1.3.8. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdPut
- 1.3.9. v2NamespacesNamespaceIdCollectionsCollectionIdGet
- 1.3.10. v2NamespacesNamespaceIdCollectionsCollectionIdPost
- 1.4. Schemas
- 1.4.1. v2SchemasKeyspacesGet
- 1.4.2. v2SchemasKeyspacesKeyspaceIdDelete
- 1.4.3. v2SchemasKeyspacesKeyspaceIdGet
- 1.4.4. v2SchemasKeyspacesKeyspaceIdTablesGet
- 1.4.5. v2SchemasKeyspacesKeyspaceIdTablesPost
- 1.4.6. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdDelete
- 1.4.7. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdGet
- 1.4.8. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdPut
- 1.4.9. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsGet
- 1.4.10. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsPost
- 1.4.11. v2SchemasKeyspacesKeyspaceIdTablesTableIdDelete
- 1.4.12. v2SchemasKeyspacesKeyspaceIdTablesTableIdGet
- 1.4.13. v2SchemasKeyspacesKeyspaceIdTablesTableIdPut
- 1.4.14. v2SchemasKeyspacesPost
- 1.4.15. v2SchemasNamespacesGet
- 1.4.16. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdDelete
- 1.4.17. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdGet
- 1.4.18. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdPut
- 1.4.19. v2SchemasNamespacesNamespaceIdCollectionsGet
- 1.4.20. v2SchemasNamespacesNamespaceIdCollectionsPost
- 1.4.21. v2SchemasNamespacesNamespaceIdDelete
- 1.4.22. v2SchemasNamespacesNamespaceIdGet
- 1.4.23. v2SchemasNamespacesPost
- 2. Models
The Stargate REST API provides CRUD operations on table data managed by Stargate.
1. Endpoints
1.1. Auth
1.1.1. v1AuthPost
POST /v1/auth
Create an auth token
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
Credentials |
X |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
Created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.2. Keyspaces
1.2.1. v2KeyspacesKeyspaceIdTableIdGet
GET /v2/keyspaces/{keyspace-id}/{table-id}
search a table
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
where |
URL escaped JSON query using the following keys: |
Key |
Operation |
|
$lt |
Less Than |
|||
$lte |
Less Than Or Equal To |
|||
$gt |
Greater Than |
|||
$gte |
Greater Than Or Equal To |
|||
$ne |
Not Equal To |
|||
$in |
Contained In |
|||
$exists |
A value is set for the key |
|||
$select |
This matches a value for a key in the result of a different query |
|||
$dontSelect |
Requires that a key’s value not match a value for a key in the result of a different query |
|||
$all |
Contains all of the given values |
|||
$regex |
Requires that a key’s value match a regular expression |
|||
$text |
Performs a full text search on indexed fields |
|||
fields |
URL escaped, comma delimited list of keys to include |
- |
null |
|
page-size |
restrict the number of returned items (max 100) |
- |
null |
|
page-state |
move the cursor to a particular result |
- |
null |
|
sort |
keys to sort by |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.2.2. v2KeyspacesKeyspaceIdTableIdPost
POST /v2/keyspaces/{keyspace-id}/{table-id}
add a new row
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
row [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.2.3. v2KeyspacesKeyspaceIdTableIdPrimaryKeyDelete
DELETE /v2/keyspaces/{keyspace-id}/{table-id}/{primary-key}
delete a row(s)
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
primary-key |
Value from the primary key column for the table. Define composite keys by separating values with slashes (`val1/val2…`) in the order they were defined. </br> For example, if the composite key was defined as `PRIMARY KEY(race_year, race_name)` then the primary key in the path would be `race_year/race_name` |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.2.4. v2KeyspacesKeyspaceIdTableIdPrimaryKeyGet
GET /v2/keyspaces/{keyspace-id}/{table-id}/{primary-key}
get a row(s)
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
primary-key |
Value from the primary key column for the table. Define composite keys by separating values with slashes (`val1/val2…`) in the order they were defined. </br> For example, if the composite key was defined as `PRIMARY KEY(race_year, race_name)` then the primary key in the path would be `race_year/race_name` |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
fields |
URL escaped, comma delimited list of keys to include |
- |
null |
|
page-size |
restrict the number of returned items (max 100) |
- |
null |
|
page-state |
move the cursor to a particular result |
- |
null |
|
sort |
keys to sort by |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.2.5. v2KeyspacesKeyspaceIdTableIdPrimaryKeyPatch
PATCH /v2/keyspaces/{keyspace-id}/{table-id}/{primary-key}
update part of a row(s)
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
primary-key |
Value from the primary key column for the table. Define composite keys by separating values with slashes (`val1/val2…`) in the order they were defined. </br> For example, if the composite key was defined as `PRIMARY KEY(race_year, race_name)` then the primary key in the path would be `race_year/race_name` |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.2.6. v2KeyspacesKeyspaceIdTableIdPrimaryKeyPut
PUT /v2/keyspaces/{keyspace-id}/{table-id}/{primary-key}
replace a row(s)
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
primary-key |
Value from the primary key column for the table. Define composite keys by separating values with slashes (`val1/val2…`) in the order they were defined. </br> For example, if the composite key was defined as `PRIMARY KEY(race_year, race_name)` then the primary key in the path would be `race_year/race_name` |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3. Namespaces
1.3.1. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDelete
DELETE /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}
delete a document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3.2. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathDelete
DELETE /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}/{document-path}
delete a sub document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
|
document-path |
a JSON path |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3.3. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathGet
GET /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}/{document-path}
get a sub document by path
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
|
document-path |
a JSON path |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
fields |
URL escaped, comma delimited list of keys to include |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.3.4. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathPatch
PATCH /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}/{document-path}
update part of a sub document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
|
document-path |
a JSON path |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.3.5. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdDocumentPathPut
PUT /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}/{document-path}
replace a sub document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
|
document-path |
a JSON path |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3.6. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdGet
GET /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}
get a document by id
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
fields |
URL escaped, comma delimited list of keys to include |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.3.7. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdPatch
PATCH /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}
update part of a document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.3.8. v2NamespacesNamespaceIdCollectionsCollectionIdDocumentIdPut
PUT /v2/namespaces/{namespace-id}/collections/{collection-id}/{document-id}
replace a document
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
|
document-id |
the id of the document |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3.9. v2NamespacesNamespaceIdCollectionsCollectionIdGet
GET /v2/namespaces/{namespace-id}/collections/{collection-id}
search for documents in {collection-id}
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
where |
URL escaped JSON query using the following keys: |
Key |
Operation |
|
$lt |
Less Than |
|||
$lte |
Less Than Or Equal To |
|||
$gt |
Greater Than |
|||
$gte |
Greater Than Or Equal To |
|||
$ne |
Not Equal To |
|||
$in |
Contained In |
|||
$exists |
A value is set for the key |
|||
$select |
This matches a value for a key in the result of a different query |
|||
$dontSelect |
Requires that a key’s value not match a value for a key in the result of a different query |
|||
$all |
Contains all of the given values |
|||
$regex |
Requires that a key’s value match a regular expression |
|||
$text |
Performs a full text search on indexed fields |
|||
fields |
URL escaped, comma delimited list of keys to include |
- |
null |
|
page-size |
restrict the number of returned items (max 100) |
- |
null |
|
page-state |
move the cursor to a particular result |
- |
null |
|
sort |
keys to sort by |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.3.10. v2NamespacesNamespaceIdCollectionsCollectionIdPost
POST /v2/namespaces/{namespace-id}/collections/{collection-id}
add a new document to {collection-id}
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
document [object] |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4. Schemas
1.4.1. v2SchemasKeyspacesGet
GET /v2/schemas/keyspaces
list keyspaces
Parameters
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.2. v2SchemasKeyspacesKeyspaceIdDelete
DELETE /v2/schemas/keyspaces/{keyspace-id}
delete a keyspace
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.3. v2SchemasKeyspacesKeyspaceIdGet
GET /v2/schemas/keyspaces/{keyspace-id}
get a keyspace
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.4. v2SchemasKeyspacesKeyspaceIdTablesGet
GET /v2/schemas/keyspaces/{keyspace-id}/tables
list tables
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.5. v2SchemasKeyspacesKeyspaceIdTablesPost
POST /v2/schemas/keyspaces/{keyspace-id}/tables
create a table
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.6. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdDelete
DELETE /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}/columns/{column-id}
delete a column
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
column-id |
column name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.7. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdGet
GET /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}/columns/{column-id}
get a column
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
column-id |
column name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.8. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsColumnIdPut
PUT /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}/columns/{column-id}
replace a column definition
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
|
column-id |
column name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.9. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsGet
GET /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}/columns
list columns
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.10. v2SchemasKeyspacesKeyspaceIdTablesTableIdColumnsPost
POST /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}/columns
create a column
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.11. v2SchemasKeyspacesKeyspaceIdTablesTableIdDelete
DELETE /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}
delete a table
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.12. v2SchemasKeyspacesKeyspaceIdTablesTableIdGet
GET /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}
get a table
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.13. v2SchemasKeyspacesKeyspaceIdTablesTableIdPut
PUT /v2/schemas/keyspaces/{keyspace-id}/tables/{table-id}
replace a table definition, except for columns
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
keyspace-id |
keyspace name |
X |
null |
|
table-id |
table name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.14. v2SchemasKeyspacesPost
POST /v2/schemas/keyspaces
create a keyspace
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.15. v2SchemasNamespacesGet
GET /v2/schemas/namespaces
list namespaces
Parameters
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.16. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdDelete
DELETE /v2/schemas/namespaces/{namespace-id}/collections/{collection-id}
delete a collection
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.17. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdGet
GET /v2/schemas/namespaces/{namespace-id}/collections/{collection-id}
get a collection
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.18. v2SchemasNamespacesNamespaceIdCollectionsCollectionIdPut
PUT /v2/schemas/namespaces/{namespace-id}/collections/{collection-id}
update (replace) a collection
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
|
collection-id |
name of the document collection |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
resource updated |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.19. v2SchemasNamespacesNamespaceIdCollectionsGet
GET /v2/schemas/namespaces/{namespace-id}/collections
list collections in a namespace
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.20. v2SchemasNamespacesNamespaceIdCollectionsPost
POST /v2/schemas/namespaces/{namespace-id}/collections
create a collection
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
1.4.21. v2SchemasNamespacesNamespaceIdDelete
DELETE /v2/schemas/namespaces/{namespace-id}
delete a namespace
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
204 |
resource deleted |
<<>> |
401 |
Unauthorized |
<<>> |
500 |
Internal server error |
<<>> |
1.4.22. v2SchemasNamespacesNamespaceIdGet
GET /v2/schemas/namespaces/{namespace-id}
get a namespace
Parameters
Path Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
namespace-id |
namespace name |
X |
null |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
|
raw |
unwrap results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
200 |
<<>> |
|
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
404 |
Not Found |
<<>> |
500 |
Internal server error |
<<>> |
1.4.23. v2SchemasNamespacesPost
POST /v2/schemas/namespaces
create a namespace
Body Parameter
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
body |
X |
Header Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
X-Cassandra-Token |
The token returned from the authorization endpoint. Use this token in each request to the database. |
X |
null |
Query Parameters
Name | Description | Required | Default | Pattern |
---|---|---|---|---|
pretty |
format results |
- |
null |
Content Type
-
application/json
Responses
Code | Message | Datatype |
---|---|---|
201 |
resource created |
<<>> |
400 |
Invalid input |
<<>> |
401 |
Unauthorized |
<<>> |
409 |
Conflict |
<<>> |
500 |
Internal server error |
<<>> |
2. Models
2.1. Credentials
User credentials for authenticating
Field Name | Required | Type | Description | Format |
---|---|---|---|---|
username |
X |
String |
Username |
|
password |
X |
String |
Password |