Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.

Headers

Idempotency-Key
string

Replays the stored answer for a retry of the same request; 409 for a different request under the same key.

Maximum string length: 255

Body

application/json
name
string
required

The business name.

Maximum string length: 200
template
string

A starter template slug; omit for a blank agent.

answers
object

Onboarding answers (the App wizard's shape).

provenance
object[]

Response

Created

id
string
required

Stable Sempera id (never a provider id).

object
any
required
status
enum<string>
required
Available options:
draft,
published,
archived,
needs_repair
name
string | null
business_name
string | null
persona
string | null
workspace_id
string | null
lifecycle
string | null
stage
string | null
published_version_id
string | null
published_version_number
integer | null
published_at
string<date-time> | null
gates
object
channels
object
readiness
object
draft
object
published
object
voice
any
language
any
instructions
any
fields
any
tools
any
knowledge
any