The Auth API from Timescale — 2 operation(s) for auth.
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/timescale:timescale-auth-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: Timescale Auth API
version: '1.0'
description: 'Operations tagged Auth across 2 of this provider''s published API definitions: timescale-ghost-openapi-original.yml, timescale-tiger-cloud-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.ghost.build/v0
description: Production
- url: https://console.cloud.tigerdata.com/public/api/v1
description: API server for Tiger Cloud
tags:
- name: Auth
paths:
/auth/info:
get:
operationId: authInfo
summary: Get authentication info
description: Returns info about the authenticated API key.
responses:
'200':
description: Authentication info
content:
application/json:
schema:
$ref: '#/components/schemas/AuthInfo'
default:
$ref: '#/components/responses/Error'
tags:
- Auth
security:
- BearerAuth: []
servers:
- url: https://api.ghost.build/v0
description: Production
/auth/logout:
post:
operationId: logout
summary: Log out
description: 'Logs the user out by revoking the given refresh token.
Requires user authentication (JWT). API keys and project access tokens
cannot be used with this endpoint.'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/LogoutRequest'
responses:
'204':
description: Logged out successfully
default:
$ref: '#/components/responses/Error'
tags:
- Auth
security:
- BearerAuth: []
servers:
- url: https://api.ghost.build/v0
description: Production
components:
schemas:
ErrorCode:
type: string
description: 'Machine-readable error code identifying a specific, client-actionable
error condition. Clients can match on this to react to specific errors
without parsing the human-readable message. Errors without a recognized
code omit this field.
'
enum:
- no_payment_method
- compute_limit_exceeded
UserInfo:
type: object
description: Authenticated user details.
required:
- id
- email
- name
properties:
id:
type: string
description: User ID.
email:
type: string
description: User email address.
name:
type: string
description: User's full name.
ApiKeyInfo:
type: object
description: Information about the API key used for authentication.
required:
- prefix
- name
- created_at
- space_id
- space_name
- user_id
- user_email
- user_name
properties:
prefix:
type: string
description: Stable prefix identifier for the API key (starts with `gt_`), identifying the key without exposing the secret.
name:
type: string
description: User-provided label for the API key.
created_at:
type: string
format: date-time
description: Time the API key was created.
space_id:
type: string
description: Space the API key is scoped to.
space_name:
type: string
description: Name of the space the API key is scoped to.
user_id:
type: string
description: ID of the user who created the API key.
user_email:
type: string
description: Email of the user who created the API key.
user_name:
type: string
description: Name of the user who created the API key.
AuthInfo:
type: object
description: Information about the authenticated caller.
required:
- type
properties:
type:
type: string
description: Type of authentication used.
enum:
- api_key
- user
api_key:
$ref: '#/components/schemas/ApiKeyInfo'
user:
$ref: '#/components/schemas/UserInfo'
LogoutRequest:
type: object
description: Request to log out by revoking a refresh token.
required:
- refreshToken
properties:
refreshToken:
type: string
description: Refresh token to revoke.
x-lint-ignore: snake-case-properties
Error:
type: object
description: Standard error response.
required:
- message
properties:
message:
type: string
description: Human-readable error message.
code:
$ref: '#/components/schemas/ErrorCode'
Error_2:
type: object
properties:
code:
type: string
message:
type: string
details:
type: string
description: 'Additional context about the failure. Often the actionable part
of the error (e.g. "bearer auth is not enabled on this server"
for a generic UNAUTHORIZED). Optional; absent on errors with no
extra detail.
'
AuthInfo_2:
type: object
description: 'Information about the authentication credentials being used. Exactly one
of `apiKey` or `oauth` is populated; the `type` field discriminates.
'
required:
- type
properties:
type:
type: string
description: 'Discriminator for the credential shape. `apiKey` for PAT callers;
`oauth` for OAuth user callers.
'
enum:
- apiKey
- oauth
example: apiKey
apiKey:
type: object
description: Information about the API key credentials
required:
- public_key
- name
- created
- project
- issuing_user
properties:
public_key:
type: string
description: The public key of the client credentials
example: tskey_abc123
name:
type: string
description: The name of the credential
example: my-production-token
created:
type: string
format: date-time
description: When the client credentials were created
example: '2024-01-15T10:30:00Z'
project:
type: object
description: Information about the project
required:
- id
- name
- plan_type
properties:
id:
type: string
description: The project ID
example: rp1pz7uyae
name:
type: string
description: The name of the project
example: My Production Project
plan_type:
type: string
description: The plan type for the project
example: FREE
issuing_user:
type: object
description: Information about the user who created the credentials
required:
- id
- name
- email
properties:
id:
type: string
description: The user ID
example: user123
name:
type: string
description: The user's name
example: John Doe
email:
type: string
format: email
description: The user's email
example: john.doe@example.com
oauth:
type: object
description: OAuth user details. Present for OAuth user callers.
required:
- user
properties:
user:
type: object
required:
- id
- name
- email
properties:
id:
type: string
description: The numeric user ID
example: '1234567'
name:
type: string
description: The user's name
example: John Doe
email:
type: string
format: email
description: The user's email
example: john.doe@example.com
responses:
Error:
description: Error response
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
ClientError:
description: Client error response (4xx status codes).
content:
application/json:
schema:
$ref: '#/components/schemas/Error_2'
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'User JWT or API key token (e.g. `gt_...`) sent as `Authorization: Bearer <token>`.'
x-refined-from:
- timescale-ghost-openapi-original.yml
- timescale-tiger-cloud-openapi-original.yml