The files API from TileDB — 4 operation(s) for files.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/tiledb-files-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Tiledb Files API
version: '1.0'
description: 'Operations tagged files across 2 of this provider''s published API definitions: tiledb-cloud-v1-openapi.yaml, tiledb-cloud-v2-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: /v1
- url: /v2
security:
- BasicAuth: []
- ApiKeyAuth: []
tags:
- name: Files
paths:
/files/{namespace}:
parameters:
- name: namespace
in: path
required: true
description: The namespace of the file
schema:
type: string
- name: X-TILEDB-CLOUD-ACCESS-CREDENTIALS-NAME
in: header
description: Optional registered access credentials to use for creation
required: false
schema:
type: string
post:
description: Create a tiledb file at the specified location
tags:
- Files
operationId: HandleCreateFile
responses:
201:
description: File created
content:
application/json:
schema:
$ref: '#/components/schemas/FileCreated'
502:
description: Bad Gateway
default:
description: error response
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FileCreate'
description: Input/Output information to create a new TileDB file
required: true
summary: Handle create file
x-summary-source: derived
servers:
- url: /v1
/files/{namespace}/upload:
parameters:
- name: namespace
in: path
required: true
description: The namespace of the file
schema:
type: string
- name: X-TILEDB-CLOUD-ACCESS-CREDENTIALS-NAME
in: header
description: Optional registered access credentials to use for creation
required: false
schema:
type: string
post:
description: Upload a tiledb file at the specified location
tags:
- Files
operationId: HandleUploadFile
responses:
201:
description: File uploaded
content:
application/json:
schema:
$ref: '#/components/schemas/FileUploaded'
502:
description: Bad Gateway
default:
description: error response
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
input_file:
type: string
description: the file to upload
format: binary
output_uri:
type: string
description: output location of the TileDB File
name:
type: string
description: name to set for registered file
required:
- input_file
summary: Handle upload file
x-summary-source: derived
servers:
- url: /v1
/files/{namespace}/{file}/export:
parameters:
- name: namespace
in: path
required: true
description: The namespace of the file
schema:
type: string
- name: file
in: path
required: true
description: The file identifier
schema:
type: string
post:
description: Export a TileDB File back to its original file format
tags:
- Files
operationId: HandleExportFile
responses:
201:
description: File exported
content:
application/json:
schema:
$ref: '#/components/schemas/FileExported'
502:
description: Bad Gateway
default:
description: error response
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FileExport'
description: Export configuration information
required: true
summary: Handle export file
x-summary-source: derived
servers:
- url: /v1
/files/{namespace}/{array}/upload:
parameters:
- name: namespace
in: path
required: true
description: The namespace of the file
schema:
type: string
- name: array
in: path
description: name/uri of array that is url-encoded
required: true
schema:
type: string
- name: X-TILEDB-CLOUD-ACCESS-CREDENTIALS-NAME
in: header
description: Optional registered access credentials to use for creation
required: false
schema:
type: string
- name: Content-Type
in: header
description: Content Type of input
required: true
schema:
type: string
default: application/octet-stream
- name: name
in: query
description: name of the TileDB array to create, if missing {array} is used
required: false
schema:
type: string
- name: filename
in: query
description: original file name
required: false
schema:
type: string
- name: filesize
in: query
description: size of the file to upload in bytes
required: true
schema:
type: integer
format: uint64
- name: mimetype
in: query
description: 'Mime type of the uploaded file. Autogenerated clients do
not always support changing the content type param. Server will
always use mimetype query param to set mimetype for file,
if it is not set Content-Type will be used
'
required: false
schema:
type: string
post:
description: Upload a file at the specified location and wrap it in TileDB Array
tags:
- Files
operationId: HandleUploadFile
responses:
201:
description: File uploaded
content:
application/json:
schema:
$ref: '#/components/schemas/FileUploaded'
502:
description: Bad Gateway
default:
description: error response
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
requestBody:
content:
application/octet-stream:
schema:
type: string
format: binary
description: File contents
description: file to upload
required: true
summary: Handle upload file
x-summary-source: derived
servers:
- url: /v2
components:
schemas:
FileCreate:
description: Input/Output information required to create a new file
type: object
properties:
input_uri:
type: string
description: storage URI of the input file
output_uri:
type: string
description: output location of the TileDB File
name:
type: string
description: name to set for registered file
FileExport:
description: Output information required to export a file
type: object
properties:
output_uri:
type: string
description: output location of the TileDB File
Error:
type: object
properties:
code:
type: integer
format: int64
message:
type: string
request_id:
type: string
FileExported:
description: Output uri of the exported file
type: object
properties:
output_uri:
type: string
description: output location of the exported file
FileUploaded:
description: Uploaded file name and information
type: object
required:
- id
properties:
output_uri:
type: string
description: output location of the TileDB File
file_name:
type: string
description: name of the file uploaded
id:
description: unique ID of the uploaded file
type: string
example: 00000000-0000-0000-0000-000000000000
x-omitempty: false
FileCreated:
description: Created file name and information
type: object
properties:
output_uri:
type: string
description: output location of the TileDB File
file_name:
type: string
description: name of the file created
securitySchemes:
BasicAuth:
type: http
scheme: basic
ApiKeyAuth:
type: apiKey
in: header
name: X-TILEDB-REST-API-KEY
OAuth2:
type: oauth2
flows:
authorizationCode:
scopes:
read: Grants read access
write: Grants write access
admin: Grants read and write access to administrative information
authorizationUrl: https://oauth2.tiledb.com/oauth2/authorize
tokenUrl: https://oauth2.tiledb.com/oauth2/token
x-refined-from:
- tiledb-cloud-v1-openapi.yaml
- tiledb-cloud-v2-openapi.yaml