Amazon Timestream

Amazon Timestream Databases API

Operations for managing Timestream databases.

Documentation GitHub OpenAPI

Operations 5

POST /#CreateDatabase Create Database #

POST /#DeleteDatabase Delete Database #

POST /#DescribeDatabase Describe Database #

POST /#ListDatabases List Databases #

POST /#UpdateDatabase Update Database #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/amazon-timestream:amazon-timestream-databases-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Amazon Timestream Query Databases API
  version: '2018-11-01'
  description: Generated from AWS's published Smithy model for Amazon Timestream Query. 5 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://ingest.timestream.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /#CreateDatabase:
    post:
      operationId: CreateDatabase
      summary: Create Database
      description: Creates a new Timestream database. If the KMS key is not specified, the database will be encrypted with
        a Timestream managed KMS key located in your account. For more information, see Amazon Web Services managed keys.
        Service quotas apply. For details, see code sample.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/CreateDatabaseResponse'
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamAccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamConflictException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamInternalServerException'
        '421':
          description: InvalidEndpointException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidEndpointException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamThrottlingException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Timestream_20181101.CreateDatabase
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/CreateDatabaseRequest'
      tags:
      - Databases
  /#DeleteDatabase:
    post:
      operationId: DeleteDatabase
      summary: Delete Database
      description: Deletes a given Timestream database. This is an irreversible operation. After a database is deleted, the
        time-series data from its tables cannot be recovered. All tables in the database must be deleted first, or a ValidationException
        error will be thrown. Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException.
        Clients should consider them equivalent. See code sample for details.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                type: string
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamAccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamInternalServerException'
        '421':
          description: InvalidEndpointException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidEndpointException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamThrottlingException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Timestream_20181101.DeleteDatabase
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/DeleteDatabaseRequest'
      tags:
      - Databases
  /#DescribeDatabase:
    post:
      operationId: DescribeDatabase
      summary: Describe Database
      description: Returns information about the database, including the database name, time that the database was created,
        and the total number of tables found within the database. Service quotas apply. See code sample for details.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/DescribeDatabaseResponse'
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamAccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamInternalServerException'
        '421':
          description: InvalidEndpointException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidEndpointException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamResourceNotFoundException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamThrottlingException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Timestream_20181101.DescribeDatabase
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/DescribeDatabaseRequest'
      tags:
      - Databases
  /#ListDatabases:
    post:
      operationId: ListDatabases
      summary: List Databases
      description: Returns a list of your Timestream databases. Service quotas apply. See code sample for details.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ListDatabasesResponse'
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamAccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamInternalServerException'
        '421':
          description: InvalidEndpointException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidEndpointException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamThrottlingException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Timestream_20181101.ListDatabases
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/ListDatabasesRequest'
      tags:
      - Databases
  /#UpdateDatabase:
    post:
      operationId: UpdateDatabase
      summary: Update Database
      description: Modifies the KMS key for an existing database. While updating the database, you must specify the database
        name and the identifier of the new KMS key to be used (KmsKeyId). If there are any concurrent UpdateDatabase requests,
        first writer wins. See code sample for details.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/UpdateDatabaseResponse'
        '403':
          description: AccessDeniedException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamAccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamInternalServerException'
        '421':
          description: InvalidEndpointException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/InvalidEndpointException'
        '404':
          description: ResourceNotFoundException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamThrottlingException'
        '400':
          description: ValidationException
          content:
            application/x-amz-json-1.0:
              schema:
                $ref: '#/components/schemas/IngestTimestreamValidationException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - Timestream_20181101.UpdateDatabase
      requestBody:
        required: true
        content:
          application/x-amz-json-1.0:
            schema:
              $ref: '#/components/schemas/UpdateDatabaseRequest'
      tags:
      - Databases
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: timestream
  schemas:
    CreateDatabaseRequest:
      type: object
      properties:
        DatabaseName:
          type: string
          description: The name of the Timestream database.
        KmsKeyId:
          type: string
          description: The KMS key for the database. If the KMS key is not specified, the database will be encrypted with
            a Timestream managed KMS key located in your account. For more information, see Amazon Web Services managed keys.
        Tags:
          type: array
          items:
            $ref: '#/components/schemas/IngestTimestreamTag'
          description: A list of key-value pairs to label the table.
      required:
      - DatabaseName
    CreateDatabaseResponse:
      type: object
      properties:
        Database:
          $ref: '#/components/schemas/Database'
    Database:
      type: object
      properties:
        Arn:
          type: string
          description: The Amazon Resource Name that uniquely identifies this database.
        DatabaseName:
          type: string
          description: The name of the Timestream database.
        TableCount:
          type: integer
          description: The total number of tables found within a Timestream database.
        KmsKeyId:
          type: string
          description: The identifier of the KMS key used to encrypt the data stored in the database.
        CreationTime:
          type: string
          format: date-time
          description: The time when the database was created, calculated from the Unix epoch time.
        LastUpdatedTime:
          type: string
          format: date-time
          description: The last time that this database was updated.
    DeleteDatabaseRequest:
      type: object
      properties:
        DatabaseName:
          type: string
          description: The name of the Timestream database to be deleted.
      required:
      - DatabaseName
    DescribeDatabaseRequest:
      type: object
      properties:
        DatabaseName:
          type: string
          description: The name of the Timestream database.
      required:
      - DatabaseName
    DescribeDatabaseResponse:
      type: object
      properties:
        Database:
          $ref: '#/components/schemas/Database'
    IngestTimestreamAccessDeniedException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    IngestTimestreamConflictException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    IngestTimestreamInternalServerException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    IngestTimestreamResourceNotFoundException:
      type: object
      properties:
        Message:
          type: string
    IngestTimestreamTag:
      type: object
      properties:
        Key:
          type: string
          description: The key of the tag. Tag keys are case sensitive.
        Value:
          type: string
          description: The value of the tag. Tag values are case-sensitive and can be null.
      required:
      - Key
      - Value
    IngestTimestreamThrottlingException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    IngestTimestreamValidationException:
      type: object
      properties:
        Message:
          type: string
      required:
      - Message
    InvalidEndpointException:
      type: object
      properties:
        Message:
          type: string
    ListDatabasesRequest:
      type: object
      properties:
        NextToken:
          type: string
          description: The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent
            API invocation.
        MaxResults:
          type: integer
          description: The total number of items to return in the output. If the total number of items available is more than
            the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value
            as argument of a subsequent API invocation.
    ListDatabasesResponse:
      type: object
      properties:
        Databases:
          type: array
          items:
            $ref: '#/components/schemas/Database'
          description: A list of database names.
        NextToken:
          type: string
          description: The pagination token. This parameter is returned when the response is truncated.
    ServiceQuotaExceededException:
      type: object
      properties:
        Message:
          type: string
    UpdateDatabaseRequest:
      type: object
      properties:
        DatabaseName:
          type: string
          description: The name of the database.
        KmsKeyId:
          type: string
          description: 'The identifier of the new KMS key (KmsKeyId) to be used to encrypt the data stored in the database.
            If the KmsKeyId currently registered with the database is the same as the KmsKeyId in the request, there will
            not be any update. You can specify the KmsKeyId using any of the following: Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab
            Key ARN: arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab Alias name: alias/ExampleAlias
            Alias ARN: arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias'
      required:
      - DatabaseName
      - KmsKeyId
    UpdateDatabaseResponse:
      type: object
      properties:
        Database:
          $ref: '#/components/schemas/Database'
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/timestream-write/service/2018-11-01/timestream-write-2018-11-01.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)

Amazon Timestream Databases API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources