Skip to main content
POST
Create or replace a form

Authorizations

Authorization
string
header
required

A workspace API key: wdy_live_… / wdy_test_…. Created at POST /workspaces/{tenantId}/keys and shown exactly once.

Body

application/json
key
string
required

The kebab-case id the model emits.

description
string
required

ENGLISH, prompt-facing: when to offer it.

Maximum string length: 600
fields
object[]
required
Maximum array length: 8
submit
object
required
successMessage
object
required
agentId
object | null

The agent this form belongs to; null = the workspace pool.

A link id from the agent, where success navigates.

notifyOwners
boolean

Response

id
string
required
agentId
object | null
required
key
string
required
description
string
required
fields
object[]
required
submit
object
required
successMessage
object
required
notifyOwners
boolean
required
createdAt
string
required
updatedAt
string
required