Tiger Cloud REST API

A comprehensive RESTful API for managing Tiger Cloud resources including VPCs, services, and read replicas

• API Version: 1.0.0
• Base URL: https://console.cloud.timescale.com/public/api/v1

Authentication

The Tiger Cloud REST API uses HTTP Basic Authentication. Include your public key and secret key in the Authorization header.

To run the samples in this API reference, add your public key and secret key as the Authorization.username and Authorization.password when you run the calls.

Basic Authentication

Authorization: Basic <base64(public_key:secret_key)>

Samples

List all services

curl -X GET "https://console.cloud.timescale.com/public/api/v1/projects/{project_id}/services" \
  -H "Authorization: Basic $(echo -n 'your_public_key:your_secret_key' | base64)"

Create a new service

curl -X POST "https://console.cloud.timescale.com/public/api/v1/projects/{project_id}/services" \
  -H "Authorization: Basic $(echo -n 'your_public_key:your_secret_key' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-production-db",
    "region_code": "us-east-1",
    "compute": {
      "cpu": "0.5",
      "memory_gb": 2
    }
  }'

Create a VPC

curl -X POST "https://console.cloud.timescale.com/public/api/v1/projects/{project_id}/vpcs" \
  -H "Authorization: Basic $(echo -n 'your_public_key:your_secret_key' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-vpc",
    "region_code": "us-east-1",
    "cidr": "10.0.0.0/16"
  }'

Create a read replica set

curl -X POST "https://console.cloud.timescale.com/public/api/v1/projects/{project_id}/services/{service_id}/replicaSets" \
  -H "Authorization: Basic $(echo -n 'your_public_key:your_secret_key' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "region_code": "us-west-2",
    "compute": {
      "cpu": "0.5",
      "memory_gb": 2
    }
  }'

API Endpoints

The REST API is organized around the following resource types:

Authentication

Get information about your API credentials:

• Get Authentication Info - GET /auth/info

Service Management

Manage Tiger Cloud database services:

• List All Services - GET /projects/{project_id}/services
• Create a Service - POST /projects/{project_id}/services
• Get a Service - GET /projects/{project_id}/services/{service_id}
• Delete a Service - DELETE /projects/{project_id}/services/{service_id}
• Start a Service - POST /projects/{project_id}/services/{service_id}/start
• Stop a Service - POST /projects/{project_id}/services/{service_id}/stop
• Resize a Service - POST /projects/{project_id}/services/{service_id}/resize
• Update Service Password - POST /projects/{project_id}/services/{service_id}/updatePassword
• Set Environment for a Service - POST /projects/{project_id}/services/{service_id}/setEnvironment
• Change HA Configuration for a Service - POST /projects/{project_id}/services/{service_id}/setHA
• Enable Connection Pooler for a Service - POST /projects/{project_id}/services/{service_id}/enablePooler
• Disable Connection Pooler for a Service - POST /projects/{project_id}/services/{service_id}/disablePooler
• Fork a Service - POST /projects/{project_id}/services/{service_id}/forkService
• Attach Service to VPC - POST /projects/{project_id}/services/{service_id}/attachToVPC
• Detach Service from VPC - POST /projects/{project_id}/services/{service_id}/detachFromVPC

Read Replica Sets

Manage read replicas for improved read performance:

• Get Read Replica Sets - GET /projects/{project_id}/services/{service_id}/replicaSets
• Create a Read Replica Set - POST /projects/{project_id}/services/{service_id}/replicaSets
• Delete a Read Replica Set - DELETE /projects/{project_id}/services/{service_id}/replicaSets/{replica_set_id}
• Resize a Read Replica Set - POST /projects/{project_id}/services/{service_id}/replicaSets/{replica_set_id}/resize
• Enable Connection Pooler for a Read Replica - POST /projects/{project_id}/services/{service_id}/replicaSets/{replica_set_id}/enablePooler
• Disable Connection Pooler for a Read Replica - POST /projects/{project_id}/services/{service_id}/replicaSets/{replica_set_id}/disablePooler
• Set Environment for a Read Replica - POST /projects/{project_id}/services/{service_id}/replicaSets/{replica_set_id}/setEnvironment

VPC Management

Manage Virtual Private Clouds for network isolation:

• List All VPCs - GET /projects/{project_id}/vpcs
• Create a VPC - POST /projects/{project_id}/vpcs
• Get a VPC - GET /projects/{project_id}/vpcs/{vpc_id}
• Delete a VPC - DELETE /projects/{project_id}/vpcs/{vpc_id}
• Rename a VPC - POST /projects/{project_id}/vpcs/{vpc_id}/rename

VPC Peering

Manage peering connections between VPCs:

• List VPC Peerings - GET /projects/{project_id}/vpcs/{vpc_id}/peerings
• Create a VPC Peering - POST /projects/{project_id}/vpcs/{vpc_id}/peerings
• Get a VPC Peering - GET /projects/{project_id}/vpcs/{vpc_id}/peerings/{peering_id}
• Delete a VPC Peering - DELETE /projects/{project_id}/vpcs/{vpc_id}/peerings/{peering_id}

Analytics

Track usage and events for analytics purposes:

• Identify a User - POST /analytics/identify
• Track an Analytics Event - POST /analytics/track