Public API & tokens

The cntct.space API lets you update link blocks on your space from your own scripts and pipelines — so the link always points at your newest video, drop, or post without you touching the editor. You mark a link as available to the API, generate a token, and PATCH the block whenever your automation runs.

This is the friendly on-ramp. For the full endpoint list, response shapes, error codes, and concurrency headers, see the API reference.

What you can do

• List your spaces and how many API-flagged blocks each has.
• List the link blocks on a space that are marked Available via API.
• Read a single API-flagged link block.
• Update an API-flagged link block — its url, title, description, thumbnailUrl, icon, badge, or schedule.

The API only ever touches link blocks you have explicitly flagged. It can't create or delete blocks, change other block types, or flip the apiUpdatable flag itself — those stay in the editor.

Generate an API token

Tokens authenticate every request. They start with the prefix cnt_live_ and are shown in full only once at creation — store the full value somewhere safe.

1. Go to API tokens under Account settings.
2. Click Generate token and give it a name (so you can tell your scripts apart later).
3. Copy the full cnt_live_... token immediately — it won't be shown again.
4. Use it as a bearer header: Authorization: Bearer cnt_live_....

The "Available via API" workflow

A link block is only reachable by the API once you turn on its Available via API toggle in the editor. That toggle also reveals the block's id, which you'll need in the request path.

1. Add a Link block to your space in the block builder.
2. Open the block and turn on Available via API.
3. Copy the Block id shown beneath the toggle.
4. Generate a token at API tokens if you don't have one.
5. PATCH the block from your script with the new url (and any other fields).

A quick example

Update one link block, replacing your-slug, the block id, and the token with your own values:

curl -X PATCH \
  https://www.cntct.space/api/v1/spaces/your-slug/blocks/<block-id> \
  -H "Authorization: Bearer cnt_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-new-link.example/","title":"Latest video"}'

To avoid overwriting a change someone else made in the editor, pass the space_updated_at value you last read back as an If-Match header — a mismatch returns a 409 so you can re-read and retry. Details are in the full reference.

Rate limits

Going over returns a 429. There's no Retry-After header — wait about 60 seconds and try again.