spintax-net Keys API
The Keys API from spintax-net — 2 operation(s) for keys.
The Keys API from spintax-net — 2 operation(s) for keys.
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/spintax-net:spintax-net-keys-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: clx management Keys API
version: 0.8.0
description: 'The /v1 API of clx (docs/spec.md §15). The clx.cx page is a thin client over the same endpoints.
Authorization: `Bearer ` from a signed-in page, or `Bearer clx_…` — an API key
(one on the `free` plan, up to 5 on `api`). Every POST, PUT, PATCH and DELETE takes an `Idempotency-Key` header, required
with an API key; a repeat with the same body replays the first answer for 24 hours.
Errors: `{ "error": { "code", "message", "details"? } }`. This file grows with each stage; a
test checks that every route in the code is here and back.'
servers:
- url: https://clx.cx
security:
- bearer: []
tags:
- name: Keys
paths:
/v1/keys:
get:
summary: API keys (page session only)
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
keys:
type: array
items:
$ref: '#/components/schemas/Key'
default:
$ref: '#/components/responses/Error'
tags:
- Keys
operationId: getV1Keys
x-operation-id-source: derived
post:
summary: Issue an API key (page session only; 1 on the free plan, 5 on api…
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
content:
application/json:
schema:
type: object
required:
- scopes
properties:
scopes:
type: array
items:
type: string
enum:
- accounts
- sites
- links
- reports
- billing
allow_accounts:
type: array
items:
type: string
pattern: ^[0-9a-f]{32}$
allow_ips:
type: array
items:
type: string
responses:
'201':
description: Issued — `key` is shown once
'409':
description: key_already_issued — a replay of the same Idempotency-Key
default:
$ref: '#/components/responses/Error'
tags:
- Keys
operationId: postV1Keys
x-operation-id-source: derived
/v1/keys/{id}:
patch:
summary: Change an API key's allow lists in place (page session only); the key itself…
description: 'A field left out stays as it is; `null` lifts the limit — every Cloudflare account of the
user, those connected later too, or every IP.'
parameters:
- $ref: '#/components/parameters/Id'
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
required: true
content:
application/json:
schema:
type: object
anyOf:
- required:
- allow_accounts
- required:
- allow_ips
properties:
allow_accounts:
type:
- array
- 'null'
minItems: 1
description: At most the plan's Cloudflare accounts
items:
type: string
pattern: ^[0-9a-f]{32}$
allow_ips:
type:
- array
- 'null'
minItems: 1
maxItems: 20
items:
type: string
responses:
'200':
description: The key as it is now
content:
application/json:
schema:
$ref: '#/components/schemas/Key'
default:
$ref: '#/components/responses/Error'
tags:
- Keys
operationId: patchV1KeysById
x-operation-id-source: derived
delete:
summary: Revoke an API key (page session only)
parameters:
- $ref: '#/components/parameters/Id'
- $ref: '#/components/parameters/IdempotencyKey'
responses:
'200':
description: Revoked
default:
$ref: '#/components/responses/Error'
tags:
- Keys
operationId: deleteV1KeysById
x-operation-id-source: derived
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
description: 'Stable codes: unauthorized, invalid_request, not_found, payload_too_large,
limit_reached, service_full, idempotency_conflict, operation_in_progress,
scope_required, session_required, key_already_issued,
account_taken, already_connected, account_not_ready, invalid_bootstrap,
bootstrap_permission_error, permission_catalog, orphan_not_deleted,
token_rights_mismatch, token_check_failed, renew_lost, rate_limited, cloudflare_unavailable,
not_configured, internal. In an account''s or operation''s `error` (the install, §4):
name_taken, resource_drift, cron_limit, permission_error, revoked, self_check_timeout,
credentials_missing, credentials_unreadable (clx cannot open the stored token),
cloudflare_error. Sites: zone_not_found, site_exists, route_conflict, site_not_active,
update_required (external sites need a newer clx-edge),
route_not_ours (a route clx made was changed outside clx and left in place).
Sign-up: email_unconfirmed (POST /v1/accounts before the address is confirmed),
invalid_password, balance_not_empty (DELETE /v1/me while money is on the balance or the partner wallet or still moving, §18).
Billing (docs/spec.md §18): insufficient_balance (Pro needs $9 on the balance), invoice_limit (3 pending top-ups),
payments_unavailable (crypto top-ups not set up or the processor down),
refund_unavailable (a top-up never credited, older than 90 days or refunded
already), refund_open (a refund of that top-up is asked for already), paused (an
object beyond the free plan''s limits: it can be read and deleted, not changed).
Links: link_exists (the code is taken on that link host), link_host_not_ready (links go
on an active host only), link_host_in_use
(DELETE /v1/link-hosts/{id} while live links are on it). In a link host''s `error`:
dns_record_exists (the named host already has a DNS record — never taken over),
domain_taken (another worker''s custom domain), domain_not_ours.
'
message:
type: string
details:
type: object
Key:
type: object
properties:
id:
type: string
prefix:
type: string
scopes:
type: array
items:
type: string
enum:
- accounts
- sites
- links
- reports
- billing
allow_accounts:
type:
- array
- 'null'
items:
type: string
allow_ips:
type:
- array
- 'null'
items:
type: string
created_at:
type: string
format: date-time
last_used:
type:
- string
- 'null'
format: date
paused_at:
type:
- string
- 'null'
format: date-time
description: 'set while the key is beyond the free plan''s limits (docs/spec.md §18): it is refused until Pro is on again'
parameters:
IdempotencyKey:
name: Idempotency-Key
in: header
required: false
schema:
type: string
minLength: 1
maxLength: 200
pattern: ^[!-~]{1,200}$
Id:
name: id
in: path
required: true
schema:
type: string
pattern: ^[A-Za-z0-9_-]{1,64}$
description: 'an id of clx: 22 characters of base64url'
responses:
Error:
description: An error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearer:
type: http
scheme: bearer