> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tented.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tented API Overview

> Create, edit, publish, measure, and delete tents, plus manage contacts, through Tented's public API.

## 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

<Info>
  Public generation endpoints are asynchronous. Create, edit, and bulk-create requests return immediately after admission, and you then poll status endpoints to track progress.
</Info>

## Base URL

Use the production base URL:

```bash theme={null}
https://api.tented.ai
```

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.

<Card title="Browse the full API Reference" icon="terminal" href="/api-reference/tents/create-a-tent">
  Every endpoint across tents, analytics, contacts, lists, imports, emails, templates, blasts, and triggered flows, with live request and response schemas.
</Card>

## Authentication

Authenticate every request with a bearer API key:

```bash theme={null}
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.

<Card title="Set up Authentication" icon="key" href="/api-reference/authentication">
  Learn how API keys work, where to create them, and which headers to send.
</Card>

## 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

```bash theme={null}
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:

```bash theme={null}
curl --request GET \
  --url https://api.tented.ai/v1/tents/f11ef3cf-8664-4fe5-a261-c5b4d647b7d1 \
  --header "Authorization: Bearer $TENTED_API_KEY"
```

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Tents" icon="rocket" href="/api-reference/creating-tents">
    Start a single tent from a prompt, template, or uploaded files.
  </Card>

  <Card title="Edit Tents" icon="pen" href="/api-reference/editing-tents">
    Queue a new generation for an existing tent.
  </Card>

  <Card title="Create Bulk Tents" icon="layers" href="/api-reference/creating-bulk-tents">
    Fan out one approved template across up to 25 items.
  </Card>

  <Card title="Read Analytics" icon="chart-bar" href="/api-reference/retrieving-tent-analytics">
    Fetch tent-level or workspace-wide analytics.
  </Card>

  <Card title="Manage Contacts" icon="users" href="/api-reference/managing-contacts">
    Create, update, and delete contacts in batches.
  </Card>
</CardGroup>