Skip to main content
POST
Start an intern run without waiting for it

Authorizations

Authorization
string
header
required

API key as bearer token in Authorization header

Path Parameters

internId
string
required

The intern to run.

Example:

"a11e0000-0000-4000-8000-000000000005"

Body

application/json

A prompt to run on the intern without holding a connection open.

input
string
required

The prompt for the run, at most 32000 characters.

Required string length: 1 - 32000
Example:

"New support ticket 48213. Case token: ct_9f2c. Investigate and reply."

session_id
string

The session to run in. Send the session_id from an earlier 202 to continue that conversation, for example to hand the intern a decision on a case it is working. Omit it to start a new session. Only a session_id this endpoint issued to the same caller on the same intern is accepted; any other is refused with 404.

Required string length: 1 - 256
Example:

"b51a0e21-368b-4780-a220-14655bf28c55"

Response

The intern accepted the prompt. The run continues on the intern.

The intern admitted the prompt. The run continues on the intern.

session_id
string
required

The session the run belongs to. Send it back to continue the conversation.

Example:

"b51a0e21-368b-4780-a220-14655bf28c55"

status
enum<string>
required

started when a new run began. steered when the session already had a run going and the prompt was delivered into it instead.

Available options:
started,
steered
Example:

"started"