Skip to main content
POST
Create a new runnable
Create a new runnable with the specified configuration. The runnable can be a prompt, flow, or agent. The config_content_parsed field must match the schema for the specified config_content_type:
  • For prompt type: Must follow the PromptRunnable schema
  • For flow type: Must follow the FlowRunnable schema
  • For agent type: Must follow the AgentRunnable schema
The config_content_sha256 field should be the SHA-256 hash of the config_content field.

Authorizations

Authorization
string
header
required

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

Body

application/json
id
string<uuid>
required

The unique identifier for the runnable

account_id
string
required

The account ID that owns this runnable

name
string
required

The name of the runnable

config_content
string
required

The raw configuration content

config_content_parsed
object
required

The parsed configuration content

config_content_type
enum<string>
required

The type of runnable configuration

Available options:
prompt,
flow,
agent
config_content_sha256
string
required

SHA256 hash of the configuration content

created_at
string<date-time>
required

When the runnable was created

updated_at
string<date-time>
required

When the runnable was last updated

description
string

Optional description of the runnable

created_by
string

The ID of the user who created this runnable

tags
string[]

Optional tags for the runnable

Response

201 - application/json

Created runnable

id
string<uuid>
required

The unique identifier for the runnable

account_id
string
required

The account ID that owns this runnable

name
string
required

The name of the runnable

config_content
string
required

The raw configuration content

config_content_parsed
object
required

The parsed configuration content

config_content_type
enum<string>
required

The type of runnable configuration

Available options:
prompt,
flow,
agent
config_content_sha256
string
required

SHA256 hash of the configuration content

created_at
string<date-time>
required

When the runnable was created

updated_at
string<date-time>
required

When the runnable was last updated

description
string

Optional description of the runnable

created_by
string

The ID of the user who created this runnable

tags
string[]

Optional tags for the runnable