spintax-net Keys API

The Keys API from spintax-net — 2 operation(s) for keys.

Operations 4

GET /v1/keys API keys (page session only) #
POST /v1/keys Issue an API key (page session only; 1 on the free plan, 5 on api… #
PATCH /v1/keys/{id} Change an API key's allow lists in place (page session only); the key itself… #
DELETE /v1/keys/{id} Revoke an API key (page session only) #

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/spintax-net:spintax-net-keys-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

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

OpenAPI Specification

spintax-net-keys-api-openapi.yml Raw ↑
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