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: 
https://api.tented.ai
All current endpoints live under the /v1 prefix:
  • POST /v1/tents
  • POST /v1/tents/{tentId}/assets
  • POST /v1/tents/{tentId}/edit
  • POST /v1/tents/{tentId}/publish
  • POST /v1/tents/{tentId}/unpublish
  • DELETE /v1/tents/{identifier}
  • POST /v1/tents/bulk
  • GET /v1/bulk-jobs/{bulkJobId}
  • GET /v1/tents/{tentId}
  • GET /v1/analytics/tent
  • GET /v1/analytics/org
  • POST /v1/contacts
  • POST /v1/contacts/update
  • POST /v1/contacts/delete
  • DELETE /v1/contacts

​
Authentication

Authenticate every request with a bearer API key: 
Authorization: Bearer tented_your_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

curl --request POST \
  --url https://api.tented.ai/v1/tents \
  --header "Authorization: Bearer $TENTED_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Acme product page",
    "prompt": "Create a landing page for Acme Analytics with a hero, customer logos, features, pricing, and lead form"
  }'
Then poll: 
curl --request GET \
  --url https://api.tented.ai/v1/tents/f11ef3cf-8664-4fe5-a261-c5b4d647b7d1 \
  --header "Authorization: Bearer $TENTED_API_KEY"

​
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.