Skip to main content
POST
Publish

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
integer
required

The unique identifier for the brand that owns the site.

site_id
string
required

The ULID of the registered site whose Agent Pages you are publishing.

Body

application/json
paths
string[]
required

Site-relative paths to publish, e.g. /pricing. 1 to 100 entries, each up to 2,048 characters. Full or protocol-relative URLs are rejected. Paths are trimmed and normalized (lowercased, trailing slash and query string dropped), and duplicates after normalization are merged. / is the homepage. The page is fetched with the first spelling sent, so a case-sensitive site gets the URL it expects.

Required array length: 1 - 100 elements

Response

One outcome per requested path, in request order, plus the brand's remaining publish quota.

results
AgentPagesPublishResult · object[]
required

One entry per requested path, in request order (after duplicates are merged).

quota
AgentPagesPublishQuotas · object
required

The brand's remaining publish quota. Only queued paths use it.