Skip to main content
POST
Create ephemeral agent

Authorizations

Authorization
string
header
required

Your iwy Service API Key. Find it at app.iwy.ai/settings.

Include it in the Authorization header:

Body

application/json

Request to create a one-time use ephemeral agent

configuration
object
required

Agent configuration (same as regular agents)

ttl_seconds
integer
default:300

Time-to-live in seconds. The agent will expire after this duration.

Required range: 60 <= x <= 86400
Example:

600

metadata
object

Optional metadata for tracking or internal use

Example:

Response

Ephemeral agent created successfully

Response containing the created ephemeral agent details

agent
object
required

The created ephemeral agent