Handling Executions

This guide covers how to manage and monitor task executions in Julep.

Starting an Execution

To start a new execution of a task:

curl -X POST "https://dev.julep.ai/api/tasks/YOUR_TASK_ID/executions" \
     -H "Authorization: Bearer $JULEP_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "input": {
             "about_user": "a software developer looking to improve work-life balance",
             "topics": ["time management", "stress reduction", "productivity"],
             "user_email": "[e-mail]"
           }
         }'

Monitoring Execution Status

To check the status of an execution:

curl -X GET "https://dev.julep.ai/api/executions/YOUR_EXECUTION_ID" \
     -H "Authorization: Bearer $JULEP_API_KEY"

Handling Awaiting Input State

If an execution is in the "awaiting_input" state, you can resume it with:

curl -X POST "https://dev.julep.ai/api/executions/resume" \
     -H "Authorization: Bearer $JULEP_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "task_token": "YOUR_TASK_TOKEN",
           "input": {
             "user_feedback": "The motivation was helpful, thank you!"
           }
         }'

Cancelling an Execution

To cancel a running execution:

curl -X PUT "https://dev.julep.ai/api/executions/YOUR_EXECUTION_ID" \
     -H "Authorization: Bearer $JULEP_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "status": "cancelled"
         }'

Streaming Execution Events

To stream events from an execution in real-time:

curl -N -H "Authorization: Bearer $JULEP_API_KEY" \
     "https://dev.julep.ai/api/executions/YOUR_EXECUTION_ID/transitions/stream"

Next Steps

• Learn about customizing tasks to create more complex workflows.

• Explore using chat features to interact with agents during task execution.