Start building

Cubitix API reference

One stable interface for CubiHub, DropIt, Linktr, CubiApps and live service status. Every response includes a request ID for support and tracing.

curl https://api.cubitixstudios.xyz/v1/hub/me \
  -H "Authorization: Bearer ctx_live_..."

Authentication

Server applications use project API keys. User-facing applications use OAuth authorization code flow with PKCE through id.cubitixstudios.xyz. Live keys start with ctx_live_; sandbox keys start with ctx_test_. Secrets are shown once and stored only as hashes.

hub:profile.read

Read Cubitix identity and linked-account status

hub:forum.read

Read forum categories, announcements, posts and replies

hub:forum.write

Create forum posts and replies as the account owner

linktr:links.read

List links owned by the linked Linktr account

linktr:links.write

Create links for the linked Linktr account

linktr:links.delete

Permanently delete owned Linktr links

linktr:analytics.read

Read click analytics for owned Linktr links

dropit:drops.read

List deliveries owned by the linked DropIt account

dropit:drops.write

Create DropIt deliveries and upload files

dropit:drops.delete

Permanently delete owned DropIt deliveries

status:read

Read current Cubitix service and component health

apps:catalog.read

Read the published CubiApps catalog and releases

Errors, limits and safety

Errors use one predictable envelope. HTTP 429 indicates a per-minute or daily limit. Create operations return 409 for conflicts and 422 for invalid data. Use the X-Request-Id response header when investigating a request.

{
  "error": {
    "code": "insufficient_scope",
    "message": "This operation requires linktr:links.write.",
    "requestId": "req_..."
  }
}

Service

Identity

GET/v1/hub/me

Current Cubitix identity

Returns the CubiHub account represented by the API key or OAuth token and its linked services.

SCOPE · hub:profile.read

Service

CubiHub

GET/v1/hub/categories

List forum categories

Returns forum categories and their current post counts.

SCOPE · hub:forum.read

GET/v1/hub/posts

List forum posts

Supports categoryId, announcements, limit and offset query parameters.

SCOPE · hub:forum.read

GET/v1/hub/posts/:id

Get a forum post

Returns a post with its replies.

SCOPE · hub:forum.read

POST/v1/hub/posts

Create a forum post

JSON body: title, content and categoryId.

SCOPE · hub:forum.write

POST/v1/hub/posts/:id/replies

Create a reply

JSON body: content.

SCOPE · hub:forum.write

Service

Linktr

GET/v1/linktr/links

List links

Returns links owned by the CubiHub-linked Linktr account.

SCOPE · linktr:links.read

POST/v1/linktr/links

Create a short link

JSON body: url and optional alias.

SCOPE · linktr:links.write

{
  "url": "https://example.com/launch",
  "alias": "launch"
}

GET/v1/linktr/links/:id/analytics

Read link analytics

Returns totals, countries, browsers, operating systems, devices and the latest 100 events.

SCOPE · linktr:analytics.read

DELETE/v1/linktr/links/:id

Delete a link

Permanently deletes an owned link and its analytics.

SCOPE · linktr:links.delete

Service

DropIt

GET/v1/dropit/drops

List deliveries

Returns deliveries owned by the CubiHub-linked DropIt account.

SCOPE · dropit:drops.read

GET/v1/dropit/drops/:id

Get a delivery

Returns delivery metadata and its file list.

SCOPE · dropit:drops.read

POST/v1/dropit/drops

Create a delivery

Multipart form: files (one or more), title, note, password and expiryHours. Supported expiryHours: 0, 24, 72, 168 and 720.

SCOPE · dropit:drops.write

DELETE/v1/dropit/drops/:id

Delete a delivery

Permanently deletes an owned delivery and its stored files.

SCOPE · dropit:drops.delete

Service

Status

GET/v1/status/services

Current service status

Returns current Cubitix service and API component health.

SCOPE · status:read

Service

CubiApps

GET/v1/apps/catalog

Published app catalog

Returns published applications and release metadata. Package downloads remain authenticated through CubiApps.

SCOPE · apps:catalog.read