Skip to main content

​
Overview

Tented’s public API lets you manage the full lifecycle of tents from your own systems without using the app UI. The current public surface supports:
  • Creating a tent from a prompt
  • Creating a tent from an approved template
  • Uploading files before generation
  • Editing an existing tent
  • Publishing and unpublishing tents
  • Creating bulk tent jobs from one approved template
  • Polling tent and bulk-job status
  • Reading tent and workspace analytics
  • Deleting tents by ID or alias
  • Creating, updating, and deleting contacts in batches
Public generation endpoints are asynchronous. Create, edit, and bulk-create requests return immediately after admission, and you then poll status endpoints to track progress.

​
Base URL

Use the production base URL:
All endpoints live under the /v1 prefix. For the complete, exhaustive list — every endpoint with its parameters, request bodies, and response schemas — see the full API Reference.

Browse the full API Reference

Every endpoint across tents, analytics, contacts, lists, imports, emails, templates, blasts, and triggered flows, with live request and response schemas.

​
Authentication

Authenticate every request with a bearer API key:
API keys are scoped to a single Tented workspace. A request can only access tents, assets, aliases, and analytics that belong to the workspace associated with that key.

Set up Authentication

Learn how API keys work, where to create them, and which headers to send.

​
Common Workflows

​
1. Single-tent flow

  • Optionally upload files with POST /v1/tents/new/assets or POST /v1/tents/{tentId}/assets
  • Create the first version with POST /v1/tents
  • Poll progress with GET /v1/tents/{tentId}
  • Iterate later with POST /v1/tents/{tentId}/edit
  • Publish or unpublish manually with POST /v1/tents/{tentId}/publish and POST /v1/tents/{tentId}/unpublish

​
2. Bulk template flow

  • Start a bulk job with POST /v1/tents/bulk
  • Poll aggregate progress with GET /v1/bulk-jobs/{bulkJobId}

​
3. Measurement and cleanup

  • Read tent-level analytics with GET /v1/analytics/tent
  • Read workspace-wide analytics with GET /v1/analytics/org
  • Delete a tent with DELETE /v1/tents/{identifier}

​
4. Contact sync

  • Create up to 25 contacts with POST /v1/contacts
  • Update up to 25 contacts with POST /v1/contacts/update
  • Delete up to 25 contacts with POST /v1/contacts/delete or DELETE /v1/contacts

​
Quickstart

​
Minimal create flow

Then poll:

​
Next Steps

Create Tents

Start a single tent from a prompt, template, or uploaded files.

Edit Tents

Queue a new generation for an existing tent.

Create Bulk Tents

Fan out one approved template across up to 25 items.

Read Analytics

Fetch tent-level or workspace-wide analytics.

Manage Contacts

Create, update, and delete contacts in batches.