Developers · Platform API v1

Build on LayerBrick.

One API key works on every brand. Predictable REST, role-scoped access, signed webhooks, and a uniform service contract across the whole ecosystem — documented per product, unified here.

Create API key Core API reference Comphive API docs OpenAPI spec llms.txt
$ curl https://albos.tr/v1/auth/me \
  -H "Authorization: Bearer lb_live_…"

# the same key, on a brand:
$ curl https://comphive.albos.tr/v1/servers?org_id=… \
  -H "Authorization: Bearer lb_live_…"

One key, every brand

lb_live_ keys are org-scoped at a fixed role — never owner — and validate identically on Core and every product API.

Uniform errors & roles

JSON errors, conventional status codes: 401, 403 with the role named, 404 that never confirms others' resources, 409 on invalid state, 429 rate-limited.

Signed webhooks

Per-product HMAC-SHA256 events with retries and delivery logs. Live today on Comphive; the same shape rolls out per brand.

Core API reference

Account & platform endpoints.

Product APIs are documented on each brand's developers page. These are the shared platform surfaces at albos.tr/v1.

EndpointAccessDescription
POST/v1/auth/request-linkpublicStart passwordless sign-in (rate-limited)
POST/v1/auth/verifypublicExchange one-time token for a session
GET/v1/auth/mesession / keyIdentity + org memberships + roles — the SSO contract
GET/v1/auth/sessionssessionList devices; revoke with DELETE /v1/auth/sessions/{id}
GET/v1/organizationssessionYour organizations; POST creates (auto wallet + distributor routing)
GET/v1/organizations/{id}/walletfinance roleBalance; /transactions for the ledger
GET/v1/organizations/{id}/tokensmemberAI-token balance (the cross-brand AI currency)
POST/v1/organizations/{id}/api-keysmanagerIssue an lb_live_ key (shown once); GET lists, DELETE revokes
POST/v1/albossessionAsk the ALBOS agent — read answers instantly, sensitive actions stage a confirmation_id
POST/v1/albos/confirmsessionExecute a staged ALBOS action (create_org, credit_wallet, grant_tokens, revoke_session)
POST/v1/albos/rejectsessionCancel a staged ALBOS action (the Cancel button)
POST/v1/organizations/{id}/kycadmin roleSubmit identity verification; GET for history, staff review at /v1/admin/kyc
GET/v1/memorysessionYour ALBOS agent memory — soul.md (you write) + memory.md (agent-curated nightly)

Full request/response schemas for every endpoint above: OpenAPI 3.1 spec. Building an agent or LLM-based integration? Start with llms.txt — a machine-readable index of what LayerBrick's API can do.

Service Contract

One lifecycle on every product.

Every brand exposes the same contract under /v1/service-contract/ on its own domain.

POST provision
POST …/activate
POST …/suspend
POST …/resize
POST …/terminate
GET …/usage
GET …/export
POST …/transfer

State machine enforced server-side; invalid transitions return 409. Export satisfies data-portability rights; transfer moves services between organizations (owner only).

Product APIs

Deep documentation lives with each product.

Comphive — live TLDName — coming NetDNS — coming DakRelay — coming Web-Ons — coming