Creating Bulk Tents

Endpoint

POST /v1/tents/bulk

This endpoint creates a bulk job that fans out template-based tent generations across multiple items.

POST /v1/tents/bulk is an async admission endpoint. The immediate response confirms which items were accepted or rejected and returns a bulk_job_id for polling.

Request Body

Top-Level Fields

Field	Type	Required	Notes
`template_id`	`string`	Yes	Approved template ID to reuse across the whole batch
`items`	`array`	Yes	Between `1` and `25` items
`client_job_descriptor`	`string`	No	Optional label for the bulk job
`default_tent_name_prefix`	`string`	No	Used when an item does not provide `tent_name`
`start_index`	`integer`	No	Starting counter for generated tent names. Defaults to `1`
`auto_publish`	`boolean`	No	Applies to the entire bulk request
`reasoning`	`min \| medium \| high \| max`	No	Controls reasoning effort for the template-based generation pass
`metadata`	`object`	No	Optional job-level metadata echoed back in responses

Item Fields

Field	Type	Required	Notes
`input_data`	`object`	Conditionally	Structured personalization data for this tent
`instructions`	`string`	Conditionally	Item-specific instructions for how the tent should be generated
`client_item_id`	`string`	No	Your own per-item identifier for reconciliation
`tent_name`	`string`	No	Overrides batch naming defaults
`custom_page_alias`	`string`	No	Requested published path for this item. Requires top-level `auto_publish: true`
`include_brand`	`boolean`	No	Pulls workspace branding into this item’s prompt

Each item must provide at least one of input_data or instructions.

Important Rules

All items in one bulk request use the same template_id
The template must exist in the same workspace as the API key
The template must already be approved and have approved content available
Tented generates every tent_id; callers cannot supply or override it
Bulk requests support partial success. Some items can be accepted while others are rejected
auto_publish is batch-wide, but each item can still request its own custom_page_alias

Request Example

curl --request POST \
  --url https://api.tented.ai/v1/tents/bulk \
  --header "Authorization: Bearer $TENTED_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "template_id": "tpl_01JABC123XYZ",
    "client_job_descriptor": "Acme onboarding batch",
    "default_tent_name_prefix": "Acme onboarding",
    "start_index": 1,
    "auto_publish": true,
    "reasoning": "high",
    "metadata": {
      "source": "crm-import",
      "batch_label": "acme-q2-onboarding"
    },
    "items": [
      {
        "client_item_id": "acme-row-001",
        "tent_name": "Acme Onboarding Page 1",
        "custom_page_alias": "acme-onboarding-jane",
        "input_data": {
          "first_name": "Jane",
          "company_name": "Acme",
          "event_time": "9 PM",
          "cta_text": "Book your onboarding kickoff"
        },
        "instructions": "Make the tone more executive and emphasize customer onboarding.",
        "include_brand": true
      },
      {
        "client_item_id": "acme-row-002",
        "custom_page_alias": "acme-onboarding-michael",
        "input_data": {
          "first_name": "Michael",
          "company_name": "Acme",
          "event_time": "10 AM",
          "cta_text": "Schedule your implementation review"
        },
        "instructions": "Keep it concise and more operations-focused."
      },
      {
        "client_item_id": "acme-row-003",
        "instructions": "Make it warmer and more personal, but keep the same structure."
      }
    ]
  }'

Instructions-Only Example

When you do not need structured template variables, you can omit input_data and use instructions alone:

curl --request POST \
  --url https://api.tented.ai/v1/tents/bulk \
  --header "Authorization: Bearer $TENTED_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "template_id": "tpl_01JABC123XYZ",
    "client_job_descriptor": "Quick test batch",
    "default_tent_name_prefix": "test",
    "auto_publish": true,
    "items": [
      {
        "client_item_id": "test-001",
        "custom_page_alias": "test-hello",
        "instructions": "Make the entire body of the page just say Hello World",
        "include_brand": true
      },
      {
        "client_item_id": "test-002",
        "custom_page_alias": "test-goodbye",
        "instructions": "Make the entire body of the page just say Goodbye World",
        "include_brand": true
      }
    ]
  }'

Each item must provide at least one of input_data or instructions. You can provide both; input_data is applied first and instructions are treated as additional guidance.

Response Example

202 Accepted

{
  "bulk_job_id": "01JQZB4H8A7T5B3R2W1X9Y6Z0K",
  "status": "accepted",
  "template_id": "tpl_01JABC123XYZ",
  "auto_publish": true,
  "accepted_count": 3,
  "rejected_count": 0,
  "items": [
    {
      "index": 0,
      "client_item_id": "acme-row-001",
      "tent_id": "b6f8d617-7cfe-4d63-a8e9-5d971780d57f",
      "tent_name": "Acme Onboarding Page 1",
      "custom_page_alias": "acme-onboarding-jane",
      "status": "accepted"
    },
    {
      "index": 1,
      "client_item_id": "acme-row-002",
      "tent_id": "85833f2b-40ba-4af4-b820-cf13f7356d7a",
      "tent_name": "Acme onboarding (2)",
      "custom_page_alias": "acme-onboarding-michael",
      "status": "accepted"
    },
    {
      "index": 2,
      "client_item_id": "acme-row-003",
      "tent_id": "53e8237e-0c87-495d-8d10-946db64dbf8d",
      "tent_name": "Acme onboarding (3)",
      "status": "accepted"
    }
  ],
  "metadata": {
    "source": "crm-import",
    "batch_label": "acme-q2-onboarding"
  },
  "created_at": "2026-03-25T14:30:00.000Z"
}

Partial Success

Bulk requests are not all-or-nothing. Individual items can be rejected during admission while the rest of the batch proceeds.

{
  "bulk_job_id": "01JQZB4H8A7T5B3R2W1X9Y6Z0K",
  "status": "accepted",
  "template_id": "tpl_01JABC123XYZ",
  "auto_publish": true,
  "accepted_count": 1,
  "rejected_count": 1,
  "items": [
    {
      "index": 0,
      "client_item_id": "valid-row",
      "tent_id": "b6f8d617-7cfe-4d63-a8e9-5d971780d57f",
      "tent_name": "Bulk Tent (1)",
      "status": "accepted"
    },
    {
      "index": 1,
      "client_item_id": "invalid-row",
      "status": "rejected",
      "error_code": "INVALID_ITEM",
      "message": "Invalid request body"
    }
  ],
  "created_at": "2026-03-25T14:30:00.000Z"
}

Possible item-level rejection codes include:

INVALID_ITEM
NOT_FOUND
INSUFFICIENT_CREDITS

Naming Behavior

If an item omits tent_name, Tented generates a name using:

default_tent_name_prefix when provided
otherwise client_job_descriptor when provided
otherwise Bulk Tent

The generated counter starts at start_index and is rendered as Prefix (N).

Auto-Publish Behavior

Set top-level auto_publish to true to publish all accepted items after generation succeeds. Each item can optionally request a different custom_page_alias. Alias rules match POST /v1/tents:

Maximum 100 characters
Lowercase letters, numbers, hyphens, underscores, and dots only
Must start with a letter or number
Must not be a UUID
Must not use reserved words such as api, admin, submit, or assets
Use / to publish at the domain root

custom_page_alias requires top-level auto_publish: true. If auto_publish is false, the affected item is rejected during admission.

Polling For Results

Use the returned bulk_job_id with GET /v1/bulk-jobs/{bulkJobId} to track aggregate progress and read final published URLs.

Next: Retrieve Bulk Job Status

Poll the bulk job until all accepted items complete or fail.

Tented API

Tents

Email

Contacts & Lists

Campaigns

Analytics

Endpoint

Request Body

Top-Level Fields

Item Fields

Important Rules

Request Example

Instructions-Only Example

Response Example

Partial Success

Naming Behavior

Auto-Publish Behavior

Polling For Results

Next: Retrieve Bulk Job Status

​Endpoint

​Request Body

​Top-Level Fields

​Item Fields

​Important Rules

​Request Example

​Instructions-Only Example

​Response Example

​Partial Success

​Naming Behavior

​Auto-Publish Behavior

​Polling For Results

Next: Retrieve Bulk Job Status

Endpoint

Request Body

Top-Level Fields

Item Fields

Important Rules

Request Example

Instructions-Only Example

Response Example

Partial Success

Naming Behavior

Auto-Publish Behavior

Polling For Results