ThinkRun

llms.txt

AI Task Planning

Describe what you want in natural language and let the AI plan and execute browser actions.

POST/api/tasks/from-text

Create an AI task plan from a natural language description. The AI breaks it into executable steps.

Body Parameters

textstringrequiredNatural language task description
sessionIdstringrequiredSession to execute on
urlstringStarting URL (if not already navigated)

Response

{
  "success": true,
  "planId": "plan-abc123",
  "tasks": [
    { "order": 1, "description": "Navigate to login page" },
    { "order": 2, "description": "Fill email field" },
    { "order": 3, "description": "Click submit button" }
  ],
  "estimatedTimeSeconds": 25,
  "estimatedCostUsd": 0.02
}
POST/api/tasks/from-audio

Create a task plan from an audio recording. Upload the audio file as multipart form data.

Body Parameters

audiofilerequiredAudio file (multipart upload)

Response

{
  "success": true,
  "planId": "plan-def456",
  "tasks": [...]
}
POST/api/tasks/from-recording

Create a task plan from a browser recording. The AI analyzes the recording to generate executable steps.

Body Parameters

recordingIdstringrequiredRecording ID to analyze
objectIdstringStorage object ID (resolved from recording if not provided)
sessionIdstringAssociated session ID

Response

{
  "success": true,
  "planId": "plan-ghi789",
  "tasks": [...]
}
POST/api/tasks/:planId/execute

Execute a task plan. The AI controls the browser step by step.

Body Parameters

sessionIdstringOverride the session (optional if set in plan)

Response

{
  "success": true,
  "planId": "plan-abc123",
  "status": "executing"
}
GET/api/tasks/:planId

Get the status of a task plan including per-task results.

Response

{
  "planId": "plan-abc123",
  "status": "completed",
  "tasks": [
    { "order": 1, "description": "Navigate to login page", "status": "completed" },
    { "order": 2, "description": "Fill email field", "status": "completed" },
    { "order": 3, "description": "Click submit button", "status": "completed" }
  ],
  "totalCostUsd": 0.018
}
POST/api/tasks/:planId/pause

Pause a running task plan. Can be resumed later.

Response

{
  "success": true,
  "status": "paused"
}
POST/api/tasks/:planId/resume

Resume a paused task plan from where it left off.

Response

{
  "success": true,
  "status": "executing"
}
POST/api/tasks/:planId/cancel

Cancel a task plan. Completed steps are preserved.

Response

{
  "success": true,
  "status": "cancelled"
}