Skip to main content
POST
Create tents in bulk

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Body

application/json
template_id
string
required

Approved template used for every item.

items
object[]
required

Items to create (1–25). Each item must provide token_data and/or prompt.

Required array length: 1 - 25 elements
client_job_descriptor
string

Label for the bulk job.

default_tent_name_prefix
string

Name prefix used when an item omits tent_name.

start_index
integer
default:1

Starting counter for generated names.

Required range: x >= 1
auto_publish
boolean

Publish every generated tent automatically. Applies to the whole batch.

reasoning
enum<string>

Reasoning effort for the generation pass.

Available options:
min,
medium,
high,
max
metadata
object

Job-level metadata, echoed back in responses.

Response

Batch admitted (possibly with per-item rejections).

bulk_job_id
string
required

Bulk job ID — poll GET /v1/bulk-jobs/{bulkJobId}.

status
string
required

Always accepted.

items
object[]
required

Admission result per item, in request order.

template_id
string

Template used.

auto_publish
boolean

Whether the batch auto-publishes.

accepted_count
integer

Items admitted.

rejected_count
integer

Items rejected at admission.

metadata
object

Echoed job metadata.

created_at
string<date-time>

Job creation time.