Skip to content
TurnitPass
DevelopersAPI v1Get an API key
Browse documentation

DevelopersAPI Keys

Create and rotate Bearer keys without losing account control

API key management lives in your TurnitPass workspace. This page documents the key lifecycle, security model, and request pattern for production integrations.

REST API v1

Your platform

Overview

workspace
GET/api/v1/status
account scoped
status check
GET /api/v1/status
curl https://turnitpass.com/api/v1/status \
  -H "Authorization: Bearer tp_live_your_api_key"

Review board

01

Key format

Keys are shown only once after creation and can be rotated from the workspace.

02

Storage

Secret material is protected after the first reveal and is never shown again.

03

Default limit

Keep production, staging, and local keys separate instead of sharing one token.

Key lifecycle

A small operating loop for each integration

1

Name the environment

Use clear labels such as Production API, Staging QA, or Partner demo so usage logs stay readable.

2

Copy the key once

The full token is only revealed on creation. Store it in your app secrets, not in client-side code.

3

Call status first

Use GET /api/v1/status to verify the key, remaining balance, limits, and account ownership before sending user text.

4

Rotate without downtime

Create the replacement key, deploy it, confirm traffic, then revoke the old key from the workspace.

Security details

What the key system guarantees

Header
Authorization: Bearer API keyEvery v1 route expects the same Bearer header shape.
Storage
Protected at restThe raw token is not shown again after first reveal.
Revocation
ImmediateA revoked key stops authenticating while the Google account and other keys remain usable.
Scope
Account ownedUsage, words, billing, and request history roll up to the authenticated workspace owner.
Implementation note. Actual key creation and revocation stay in the workspace because they require a signed-in account. Public documentation should explain the lifecycle without exposing secret material.
Next, make it part of your workflow.Continue reading