The v2 routes of the TileDB Cloud REST API — 21 operations concentrated on groups, assets, array metadata, files, notebooks, users and organizations. Published by TileDB as a separate Swagger 2.0 contract with basePath /v2, sharing the same authentication schemes as v1.
This API exposes
21 operations
across 13 paths,
organized into 6 resource areas,
and defines 73 schemas.
It is described by OpenAPI 2.0, at version 1.4.0.
Requests are made against the base URL https://api.tiledb.com/v2.
21 operations13 paths73 schemas3 DELETE5 GET1 OPTIONS2 PATCH8 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 2.0
API Version
1.4.0
Base URL
https://api.tiledb.com/v2
Authentication
basic, API Key, OAuth 2.0
Resource Areas
6
Authentication & Security 3
TileDB Storage Platform API (v2) declares
3 security schemes
for authenticating requests.
It defines a basic scheme (BasicAuth).
An API key is passed in the header as X-TILEDB-REST-API-KEY (ApiKeyAuth).
It supports OAuth 2.0 (OAuth2) using the accessCode flow, exposing 3 scopes.
By default, every request must be authenticated.
Paths & Operations 21
Across 13 paths, the API surfaces 21 operations — 3 DELETE, 5 GET, 1 OPTIONS, 2 PATCH, 8 POST, 2 PUT. They span 6 resource areas: array, query, user, groups, files, notebooks. Each is listed below with its method, path, parameters, and response codes.
array 2
POST
/arrays/{namespace}/{array}
Get a array at a specified URI registered to a group/project
getArray4 params→ 200502default
GET
/arrays/{namespace}/{array}/activity
get array activity logs
arrayActivityLog9 params→ 200502default
query 1
POST
/arrays/{namespace}/{array}/query/submit
send a query to run against a specified array/URI registered to a group/project
submitQuery8 params→ 200204502default
user 5
GET
/credentials/{namespace}
List the credentials available in the namespace
listCredentials5 params→ 200502default
POST
/credentials/{namespace}
Create a new credential for the namespace
addCredential6 params→ 204502default
GET
/credentials/{namespace}/{name}
Retrieve an access credential by name
getCredential2 params→ 200502default
PATCH
/credentials/{namespace}/{name}
Update the named access credential. This will also update the information used to access arrays set to use this credential.
updateCredential3 params→ 204502default
DELETE
/credentials/{namespace}/{name}
Delete the named access credential. Any arrays still set to use this credential will use the namespace's default and may become unreachable.
deleteCredential2 params→ 204502default
groups 11
POST
/groups/{group_namespace}/{group_name}/metadata
get metadata on a group using the requested config
Retrieves combined activity logs for all assets contained in a group.
getGroupContentActivity4 params→ 200502default
GET
/groups/{group_namespace}/{group_name}/activity
Retrieves activity logs for all assets contained in a group (arrays and other groups) including the parent group itself.
getGroupActivity6 params→ 200502default
files 1
POST
/files/{namespace}/{array}/upload
Upload a file at the specified location and wrap it in TileDB Array
HandleUploadFile9 params→ 201502default
notebooks 1
POST
/notebooks/{namespace}/{array}/upload
Upload a notebook at the specified location and wrap it in TileDB Array
HandleUploadNotebook6 params→ 201502default
Schemas 73
The contract defines 73 schemas that model the data the API accepts and returns. The most detailed are FragmentMetadata (29 properties), ArraySchema (14 properties), ArrayDirectory (14 properties), GenericTileOffsets (11 properties). Each schema is shown below with its type and property counts.
AssetType
string
Asset types represented as TileDB arrays
Datatype
string
TileDB data type
Layout
string
Layout of array
Querytype
string
Type of query
Querystatus
string
Status of query
DomainArray
object
Domain object for an array of each type
10 properties
Array
object
Represents an open array
11 properties2 required
FragmentMetadata
object
Metadata of a fragment
29 properties
GenericTileOffsets
object
Array directory (for reads)
11 properties
ArrayDirectory
object
Array directory (for reads)
14 properties
DeleteAndUpdateTileLocation
object
the location of delete tiles
3 properties
TimestampedURI
object
the timestamped filtered array metadata URIs, after removing the ones that need to be vacuumed and those that do not fall within
3 properties
ArraySchemaMap
object
array's schemas
1 property
ArraySchemaEntry
object
key/value pair representing an array schema map entry
2 properties
NonEmptyDomainList
object
object containing non empty domains
1 property
NonEmptyDomain
object
object representing a non-empty domain
3 properties2 required
ArrayType
string
TileDB array type
Attribute
object
Attribute of array
7 properties4 required
FilterType
string
TileDB filter types
Filter
object
Filter
3 properties1 required
FloatScaleConfig
object
FloatScaleConfig
3 properties
FilterPipeline
object
One or more filters to apply
1 property
Dimension
object
Dimension of array
6 properties3 required
Domain
object
Domain of array
4 properties4 required
ArraySchema
object
ArraySchema during creation or retrieval
14 properties9 required
ArrayMetadataEntry
object
key/value pair representing an array metadata map entry
5 properties
ArrayMetadata
object
user's TileDB array metadata
1 property
AttributeBufferHeader
object
Represents an attribute buffer header information
7 properties3 required
Writer
object
5 properties
SubarrayRanges
object
A set of 1D ranges for a subarray
5 properties
Subarray
object
A Subarray
2 properties
SubarrayPartitioner
object
The subarray partitioner
6 properties
ReadState
object
state for reads
4 properties
QueryReader
object
Read struct (can't be called reader due to class name conflict)
3 properties
Query
object
10 properties7 required
AttributeBufferSize
object
object representing buffer size of an attribute
3 properties3 required
AssetActivityLog
object
6 properties5 required
ArrayActivityLog
object
Activity of an Array
9 properties
ActivityEventType
string
Type of activity logged
ArrayActivityLogData
object
Object including array tasks and metadata
2 properties
PaginationMetadata
object
4 properties
Error
object
3 properties
AccessCredentialType
string
The types of an access credential
AccessCredential
object
A union type which may contain a credential to access any one cloud provider.
10 properties
AccessCredentialsData
object
Object including credentials and pagination metadata
2 properties
AWSCredential
object
Credential information to access Amazon Web Services
4 properties
AzureCredential
object
Credential information to access Microsoft Azure. Each supported property is the snakecase version of its name in an Azure Storage connection string.
2 properties
GCPInteroperabilityCredential
object
Credential information to access Google Cloud. using well knows key/secret pair to access storage.
2 properties
AWSRole
object
Role information to access Amazon Web Services
4 properties
AzureToken
object
Token information to access Azure services
2 properties
GCPServiceAccountKey
object
The key to a Google Cloud Platform service account.
3 properties
CloudProvider
string
A service where data is stored or computations take place.
MetadataEntry
object
key/value pair representing a group metadata map entry
5 properties
Metadata
object
user's TileDB metadata
1 property
GroupCreationRequest
object
information for creating a new group with the passed configuration
2 properties1 required
GroupCreationResponse
object
Information of the created group
3 properties
GroupRegistrationRequest
object
information for creating a new group with the passed configuration
2 properties1 required
GroupContentsRetrievalResponse
object
Object including a page of members of a group and pagination metadata
2 properties
GroupContentsRetrievalRequest
object
Request the contents of a group
1 property
GroupContentsChangesRequest
object
Updates the contents group
2 properties
GroupMetadataUpdateRequest
object
Updates the metadata of a group
2 properties1 required
GroupMetadataRetrievalRequest
object
Retrieves the metadata of a group
1 property
GroupMemberType
string
File types that can be included in groups
GroupMemberAssetType
string
Specific file types of group members
GroupMember
object
A groups member, array or another groups, to add or remove from an existing group.
3 properties
GroupContentActivity
object
Object containing activity of an asset of a group
2 properties
GroupContentActivityResponse
object
Object containing activity logs of group content along with the pagination metadata
2 properties
GroupActivityResponse
object
Object containing activity logs of a group and its content (arrays and subgroups) along with pagination metadata
2 properties
GroupActivityEventType
string
Event type of Group activity
TileDBConfig
object
TileDB config used for interaction with the embedded library
1 property
FileUploaded
object
Uploaded file name and information
3 properties1 required
NotebookUploaded
object
Uploaded notebook name and information
3 properties1 required
ArrayFetch
object
Model for opening an array v2
2 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of TileDB Storage Platform API (v2), published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.