Loading your workspace…
Loading your workspace…
The same operations as your workspace, with explicit permissions and account boundaries.
Sign in to the workspace and create a token under ‘API & tokens’. Keep the secret in your own system. Send it as a Bearer header. You can revoke it immediately; choose an expiry of up to 365 days.
Authorization: Bearer <YOUR_TOKEN> Content-Type: application/json
Read and write scopes are separate for prints, links, websites and generation. Tokens cannot create more tokens. Publish Smart Links through your browser session after reviewing the preview. A token for one Smart Link can only edit that draft.
curl https://omnitechs.nl/api/v1/calculator \ -F "[email protected]" curl https://omnitechs.nl/api/v1/calculator/<FILE_ID> \ -H "x-estimate-token: <FILE_TOKEN>" \ -H "Content-Type: application/json" \ -d '{"unit":"mm","scalePercent":100,"materialId":"pla","colourId":"unsure","qualityId":"standard","useId":"functional","quantity":1,"customerTypeId":"private"}'
Above 32 MB the browser uses pieces: POST /api/print-estimates/uploads with JSON {fileName,sizeBytes}; keep id and token. PUT sequential 8 MiB pieces to /api/print-estimates/uploads/{id}/{index} (starting at 0) with x-print-upload-token. POST to /complete returns the normal file ID/token for the calculator. These routes require the website's same Origin. DELETE on the session cancels unfinished pieces. The multipart route above retains its 40 MiB bound. Never automatically replay a lost completion response; only explicit busy can be retried.
STL/3MF: up to 256 MB. An estimate is not an accepted quote or print order. Submitted calculator files: up to 90 days; other uploads: 7 days. Quote acceptance retains a separate private copy for production and support. These copies do not yet have automatic deletion; see the privacy policy. Addresses currently support the Netherlands.
Optional commercial on POST /prints: qualityService (customer_prepared or full_review), removeSupports, brandId or null, gift (recipient and message) or null, and fulfilment ({timing:now} or {timing:scheduled,requestedDate:YYYY-MM-DD}). Quantity and print quality come from retained calculator choices. The workshop confirms the file, capacity and delivery date before a payable quote. customer_prepared still includes mandatory machine and safety checks.
{
"qualityService": "full_review",
"removeSupports": true,
"brandId": null,
"gift": {
"recipient": "Alex",
"message": "Happy birthday"
},
"fulfilment": {
"timing": "now"
}
}Service prices in cents including 21% VAT, before scheduling factor: {"fullReviewInclVatCents":4900,"supportRemovalPerUnitInclVatCents":450,"brandingInclVatCents":1200,"giftPerUnitInclVatCents":950}. The server calculates and freezes all lines in quote.commercial. Amounts, factors or a client quantity in commercial are rejected. Shipping stays separate.
Shipping under your brand requires prior registration: upload your own PNG/JPEG through POST /images, then POST /prints/brands with name, logoId and packingNote. GET /prints/brands lists your active brands. Use their id as brandId. DELETE /prints/brands/{id} archives it for new requests; existing requests retain their brand. Up to 20 active brands; invoice identity stays unchanged.
Use generation:write to start a base generation. Balance is reserved; a failed provider task is refunded. Use one idempotency-key per attempt and reuse it after a network failure. Keep the body unchanged for that key. Each account can have up to three active tasks.
curl https://omnitechs.nl/api/v1/generation \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-H "idempotency-key: <OPAQUE_ATTEMPT_ID>" \
-H "Content-Type: application/json" \
-d '{"kind":"text","prompt":"A simple low-poly planter","imageIds":[]}'Check /capabilities for availability. Results are retained locally before a task becomes ‘SUCCEEDED’. Download them with generation:read. Image generation accepts your own JPEG/PNG upload IDs; external image URLs are refused.
GET /billing/balance with generation:read returns your owned balance and the digital-credit conversion to euros. Tokens scoped to one Smart Link cannot access the account balance.
Base generation reserves funds from your prepaid balance. In ‘Account and payments’, opt into automatic top-ups with an amount, balance threshold and UTC monthly cap. Stripe stores the payment method. Consent and disabling require your browser session; API tokens cannot change this mandate. A pending top-up cannot create a second charge. Bank authentication uses the same invoice's recovery link in your account.
After a print quote is reviewed, POST /prints/{id}/pay with prints:write and explicitly granted prints:pay, revision, quoteId, accepted:true and locale. It spends the same balance without Checkout for each order. Insufficient funds may trigger your opted-in top-up. A 402 means the order remains unpaid: inspect balance, monthly cap or authentication, then safely retry the same quote. A started Checkout cannot also be paid from balance.
Upgrade funded Pro to Business in the panel: first get the current proration, then authorize the exact amount. Only the difference for the remaining period is charged to your saved payment method; the renewal date stays the same. Failed payment retains funded Pro and recovery uses the same Stripe invoice. POST /links/subscription with action quote_upgrade or upgrade is browser-session only; upgrade requires quoteId, consent:true and the current consentVersion from the contract. Tokens cannot purchase or change subscriptions.
Business includes one active custom domain. GET /links/domain returns DNS instructions; POST with action connect, verify or remove requires your signed-in browser session. API tokens cannot claim a domain. Your account must prove ownership with the _omnitechs TXT record. The domain serves only a published page with a valid paid Business plan, active HTTPS and current DNS ownership proof. Disconnecting a domain does not cancel your subscription.
Pro: €15/month including VAT, 100 new MCP sessions. Business: €25/month including VAT, 1000 sessions and a custom domain once domain verification is available. Subscribe and cancel renewal in the panel. The paid period remains valid; quotas use UTC calendar months, not invoice periods.
Free: 5 new MCP sessions per UTC calendar month across all your links and tokens. See usage in the panel. Continuing the same session does not count again, including across a month boundary.
Save the Mcp-Session-Id returned by initialize and send it with every subsequent request; your Bearer token is still required. Keep your own Idempotency-Key for initialize as well. Without that key, identical initializations within 120 seconds recover the same session. DELETE /mcp closes the session without refunding usage. On 402, existing sessions remain usable. On 404, initialize again.
Build pages using sections and a theme. The same JSON works in the editor, REST API and MCP. V1 pages with only actions remain valid. Up to 40 sections, 20 items per section and 48 KiB of page JSON; transport requests up to 64 KiB.
// Node.js: create an account-owned draft. Supply your own secret from the environment.
const base = 'https://omnitechs.nl/api/v1';
const headers = {
Authorization: 'Bearer ' + process.env.OMNITECHS_TOKEN,
'Content-Type': 'application/json',
};
const page = {
"title": "My page",
"intro": "",
"accent": "forest",
"actions": [],
"version": 2,
"theme": {
"background": "#f7f5ef",
"foreground": "#202a25",
"accent": "#245d46",
"font": "sans",
"width": "comfortable",
"radius": "soft",
"buttonStyle": "solid",
"spacing": "comfortable"
},
"sections": [
{
"id": "about",
"type": "text",
"title": "About",
"text": "Your own content",
"image": "",
"imageAlt": "",
"url": "",
"items": [],
"align": "left",
"columns": 2,
"surface": "plain",
"hidden": false,
"html": "",
"css": "",
"javascript": "",
"height": 320
}
]
};
const response = await fetch(base + '/links', {
method: 'POST', headers, body: JSON.stringify(page),
});
if (!response.ok) throw new Error('Create failed: ' + response.status);
const { record } = await response.json();
// Send the current revision. On 409, reread and reconcile before retrying.
const saved = await fetch(base + '/links/' + record.id, {
method: 'PATCH', headers,
body: JSON.stringify({ revision: record.revision, data: page }),
});
if (!saved.ok) throw new Error('Save failed: ' + saved.status);Custom HTML/CSS/JavaScript widgets are isolated: no access to account cookies or the parent page, no fetch, forms or nested frames. Publish only content you have reviewed. External HTTPS images load in the browser; embeds support YouTube, Vimeo and Calendly.
Create a Smart Link in the workspace and issue a token for that link. Connect your AI to /api/v1/mcp using Streamable HTTP and a Bearer header. Tools: get_smart_link and update_smart_link. Send the current revision when editing. A conflict does not overwrite changes; reload the draft.
MCP supports protocol 2025-11-25, 2025-06-18 and 2025-03-26. The client must accept both application/json and text/event-stream. There is no OAuth sign-in flow; choose a client that supports custom Bearer headers.
/websites saves your project goal and platform choice: wordpress, nextjs or advise. One free site per account, hosted by OmniTechs. A draft does not allocate a website space. Check GET /capabilities: only when websiteProvisioning:true may you POST /websites/{id}/provision with the current revision and websites:write. A 202 response acknowledges the project; poll GET /websites/{id} until ready, failed or capacity_blocked. Only ready includes a verified public URL. Retrying retains the same allocation.
With advise, a regular website selects the static Next.js starter and a shop selects WordPress. The Next.js starter does not provide a shop; that combination returns 422. On 409, refresh the revision or open the project already using your free allocation. On 503, your draft is retained: hosting is disabled or full.
After ready, POST /websites/{id}/source with revision and websites:read. The response is a private tar.gz source archive of up to 1 MiB; x-content-sha256 contains its SHA-256. Recovery archives and passwords are excluded. Request WordPress credentials through your browser session using POST /websites/{id}/credentials, revision and your current OmniTechs password. API tokens are forbidden and attempts are limited to five per minute. These are the initial WordPress credentials; a subsequently changed WordPress password is not reset.
For Next.js, the source archive contains your static website code. For WordPress, it contains hosting configuration; export page content through WordPress → Tools → Export. Private database and recovery backups are not supplied as source archives.
The same queue handles /websites/{id}/edit (revision, title, description; static Next.js page only), /pause and /resume (revision). Use websites:write and poll the project after 202. Pause stops the site and retains files, database and the free allocation. Resume rechecks capacity and public identity. Edit WordPress content in its native editor.
POST /websites/{id}/restore requires your browser session, revision, current OmniTechs password and confirmRestore:true. API tokens cannot restore. It replaces the site and WordPress database with the initial backup, retaining a recovery copy first and causing temporary downtime. A failed edit or restore stays stopped for explicit recovery. All hosting mutations return 503 while websiteProvisioning:false.
MCP: list_websites and get_website read your owned projects. create_website creates only a draft; update_website_draft edits it. provision_website, edit_website_content, pause_website and resume_website request a host action with the current revision. Then check get_website: queued is not ready. After an ambiguous draft creation, read the list before creating again. get_website_owner_actions hands restore, source, credentials and permanent deletion to the signed-in owner; MCP provides only a handoff for these actions. Restore, credentials and deletion require the owner; source remains available through the existing REST route with websites:read. One free active site; verified deletion allows a replacement.
The same steps are available through MCP: get_website_resources, quote_website_resources, get_website_resource_purchase, pay_website_resources and cancel_website_resource_quote. Create a token with only the website permissions you need. Payment requires both websites:write and websites:pay; an editing token does not gain payment authority. Continuing in the same MCP session does not consume another connection.
Your free active site includes 200 MB of real storage. Extra storage, RAM and shared CPU are prepaid separately for one year; monthly prices are comparisons only. Prices include 21% VAT. CPU is a shared limit, not a dedicated processor or performance guarantee.
{
"acceptedTotalInclVatCents": 18000,
"consent": true,
"consentVersion": "annual-resources-2026-10-10"
}To renew: POST /websites/{id}/resources/renewal with revision and a new idempotencyKey, or MCP quote_website_resource_renewal. The server selects only your periods that expired or end within 30 days. Pay the returned purchase through the same pay endpoint with exact consent. Early renewal preserves the paid end date; expired periods start a new year at activation preparation. Physical storage, RAM and CPU stay unchanged. terminalPeriods in GET shows each confirmed latest resource period; funded future periods are not sold again.
A balance-funded upgrade with no server attempt can be returned to the same balance once through POST /websites/{id}/resources/{purchaseId}/refund with confirmBalanceRefund:true. MCP: refund_unstarted_website_upgrade. This requires websites:write and websites:pay and is not a card refund. Once work has started, a year is active or payment is uncertain, it is refused; retain the purchase ID for support.
Quotes are held for one hour; capacity is rechecked before payment. A successful prepaid recharge remains available if host capacity later disappears. Only an unfunded reservation without an open Checkout can be released with DELETE. The fixed UTC annual period is shown in the active purchase; renewal is manual. After expiry the site stops, retaining files and allocated space for recovery. Resume does not create a new paid year.
GET /api/v1/generation/studioRead owned projects and versions; generation:read; offset pages of 50POST /api/v1/generation/studioQuote, start, refresh, save draft or update owned project; generation:write. Start requires a UUID attemptId, approvedCredits and priceVersion from quote. Same attempt must be reused on retry. Input follows StudioInput with operation-specific validation.GET /api/v1/generation/studio/projectRead brief, bounded conversation, revision and assistantPending for an owned active project; projectId UUID query; generation:read.POST /api/v1/generation/studio/projectSave a brief with projectId and expected revision; generation:write. Stale revisions or pending assistant requests return409. No provider execution.POST /api/v1/generation/studio/assistantPropose a validated studio edit from message, input, locale and current project revision; generation:write. Server-held conversation only; caller history refused. Durable pending claim prevents concurrent provider calls; unresolved requests require operator recovery. No generation or wallet authority. Separate provider activation required.GET /api/v1/dropshippingRead account-owned dropshipping products, material stock, orders and offered filament; dropshipping:readPOST /api/v1/dropshippingEnrol, register incoming material, submit orders or cancel; dropshipping:write. Reuse operationId on retry; revision conflicts return409.POST /api/v1/dropshipping/paymentsBuy offered filament, resume shipping/filament checkout or cancel an unpaid purchase; dropshipping:pay. Payment only confirmed by Stripe, never by redirect.POST /api/v1/dropshipping/shippingConnect/disconnect customer DHL; browser session only, encrypted credentialsGET /api/v1/dropshipping/products/{id}/fileDownload private owned STL; photo=1 for retained image; dropshipping:readGET /api/v1/dropshipping/orders/{id}/invoiceDownload production invoice PDF; dropshipping:readGET /api/v1/dropshipping/orders/{id}/labelDownload confirmed DHL label; dropshipping:readGET /api/v1/billing/rechargeRead owned recharge settings, month cap and payment recovery (browser session only)401: sign in or replace an invalid token. 403: check scopes and browser origin. 409: reload the revision or check the earlier generation attempt. 429: wait or reduce usage. 503: dependency unavailable. Keep x-request-id for support; never include your token in logs or URLs.
Workspace: 30 requests per minute per IP and 90 per account. Calculator per IP: 20 uploads and 60 calculations per hour, 90 status requests per minute. Up to 50 records per type and 20 active API tokens. Requests and downloads are private and are not publicly cached.
POST /api/v1/billing/rechargePrepare explicit automatic recharge consent or disable it (browser session only); saved payment details stay in StripeGET /api/v1/billing/balanceRead owned prepaid balance using account-wide generation:read; contains no payment credentialsPOST /api/v1/prints/{id}/payAccept a reviewed print quote and pay atomically from prepaid balance with prints:write plus explicitly granted prints:pay; opted-in recharge may replenish funds. Existing editing tokens do not gain financial authorityGET /api/v1/prints/brandsList up to 20 owned active packaging brands with account-wide prints:readPOST /api/v1/prints/brandsRegister immutable packaging brand with prints:write and an owned PNG/JPEG logo ID previously uploaded through /images. No SVG, foreign image, arbitrary URL or invoice identity changeDELETE /api/v1/prints/brands/{id}Archive owned packaging brand with prints:write; existing immutable requests retain their recorded brand, new applications cannot select itGET /api/v1/printsList account-owned printsPOST /api/v1/printsCreate account-owned printsGET /api/v1/linksList account-owned linksPOST /api/v1/linksCreate account-owned linksGET /api/v1/websitesList account-owned website draftsPOST /api/v1/websitesCreate account-owned website draftsGET /api/v1/links/{id}Read account-owned Smart LinkPATCH /api/v1/links/{id}Save Smart Link with revision checkingGET /api/v1/websites/{id}Read account-owned website draftPATCH /api/v1/websites/{id}Save website draft with revision checkingGET /api/v1/websites/{id}/resourcesRead owned annual storage/RAM/shared CPU prices, activation availability and applied resource state with websites:readPOST /api/v1/websites/{id}/resourcesReserve an incremental annual quote with websites:write, current revision and a UUID idempotency key; fresh physical capacity is required before fundingGET /api/v1/websites/{id}/resources/{purchaseId}Read only this owned annual purchase with websites:read; paid is applying until exact host activation proof commits activeDELETE /api/v1/websites/{id}/resources/{purchaseId}Cancel only an owned unfunded non-Checkout reservation with websites:write; funded/ambiguous work retains recovery and capacityPOST /api/v1/websites/{id}/resources/renewalReserve a manual annual renewal quote for all owned terminal periods expired or ending within 30 days; websites:write, current revision and stable UUID required. Physical limits stay unchanged. Early renewal preserves paid time; an expired term starts at activation preparation. No payment until exact consent through the shared purchase pay endpointPOST /api/v1/websites/{id}/resources/{purchaseId}/payAccept the exact annual quote and spend prepaid balance once with websites:write plus explicitly granted websites:pay; opted-in bounded recharge can replenish funds, with fresh capacity checked again before debitPOST /api/v1/websites/{id}/resources/{purchaseId}/refundReturn an owned balance-funded annual payment to prepaid balance once, only before the first host attempt; requires websites:write and websites:pay. Active, attempted, uncertain and Checkout-funded purchases require support recoveryPOST /api/v1/websites/{id}/provisionQueue or retry your one free Mac-hosted website when provisioning is enabledPOST /api/v1/websites/{id}/sourceDownload your ready website's Git source archive using websites:read; recovery archives and credentials are excludedPOST /api/v1/websites/{id}/editQueue static Next.js title/description changes with websites:write; retain a recovery copyPOST /api/v1/websites/{id}/restoreQueue initial-backup restore with browser reauthentication and explicit consent; API tokens forbiddenPOST /api/v1/websites/{id}/pauseQueue an owned site stop using websites:write; retain files, database and allocationPOST /api/v1/websites/{id}/resumeQueue the same paused site using websites:write; capacity and public identity are verified againPOST /api/v1/websites/{id}/deleteDelete an owned hosted website, its files/database/recovery archives and release the active free allocation; browser reauthentication and explicit consent required, API tokens forbiddenPOST /api/v1/websites/{id}/credentialsReveal initial WordPress credentials with a same-origin browser session and password reauthentication; API tokens are forbiddenGET /api/v1/prints/{id}Read your saved print applicationGET /api/v1/prints/{id}/fileDownload your original print file within its retention windowGET /api/v1/prints/{id}/receiptDownload an owned paid print's payment confirmation PDF with prints:read; not a tax invoicePOST /api/v1/prints/{id}/checkoutAccept the current reviewed quote with prints:write and obtain a hosted payment URLGET /api/v1/generationList your generation jobsPOST /api/v1/generationReserve balance and start a base Meshy generationGET /api/v1/generation/{id}Poll your provider task and settle its outcomeGET /api/v1/generation/files/{id}/{format}Download your retained local modelPOST /api/v1/imagesUpload an account-owned image, up to 8 MiB, for prints, generation or dropshipping (matching write scope required)GET /api/v1/tokensBrowser session: list redacted token metadataPOST /api/v1/tokensBrowser session: issue a one-time tokenDELETE /api/v1/tokens/{id}Browser session: revoke your token immediatelyPOST /api/v1/calculatorPublic STL/3MF upload, up to 40 MiBGET /api/v1/calculator/{id}Read an estimate with its private capabilityPOST /api/v1/calculator/{id}Queue slicing with approved material, quality and quantity choicesDELETE /api/v1/mcpClose the currently owned token-bound MCP session; no quota refundPOST /api/v1/mcpSmart Link MCP Streamable HTTP; link scopes and JSON-RPC 2.0GET /api/v1/links/usageRead owned MCP new-session usage and UTC calendar-month limit; browser session onlyGET /api/v1/links/subscriptionRead owned Smart Link subscription and current prices (browser session only)POST /api/v1/links/subscriptionConsent to a monthly subscription or cancel the next renewal (browser session only)GET /api/v1/links/domainRead owned custom-domain state and DNS instructions (browser session only)POST /api/v1/links/domainConnect, verify or remove one Business custom domain (browser session only)GET /api/v1/capabilitiesRead current generation and provisioning availability without secretsGET /api/v1/openapiRead this OpenAPI contract