Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.getlark.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Execution statuses

Each workflow run moves through these statuses:
StatusMeaning
pendingQueued, waiting to start.
runningThe agent is performing the test.
successThe test passed.
failureThe test failed.
cancelledYou cancelled the run before it finished.
Deterministic failures trigger a summarization step. Lark classifies the failure as a script issue (auto-repair) or a product regression (alert via Slack/Linear). AI-driven executions skip this step. Check an execution’s status in the dashboard or through the API: 
curl https://api.getlark.ai/workflows/wf_abc123/executions/exec_xyz789 \
  -H "X-API-Key: $GETLARK_API_KEY"

​
Artifacts

Each execution can produce artifacts: files the agent captured or generated during the test. You can download them from the dashboard or through the API. Screenshot showing the artifacts in the execution detail page in dashboard.

​
Artifact types

TypeDescription
screenshotA screenshot the agent took during the test.
videoA recording of the full test session.
javascriptJavaScript code the agent executed.
pythonPython code the agent executed.
shellscriptShell commands the agent ran.

​
Accessing artifacts (API)

Artifacts appear in the execution response under the artifacts array. Each entry includes:
  • artifact_type - One of the types above.
  • filename - The file name.
  • presigned_url - A download URL.
  • presigned_url_expires_at - When the URL stops working.
{
  "artifacts": [
    {
      "artifact_type": "screenshot",
      "filename": "login-page.png",
      "presigned_url": "https://...",
      "presigned_url_expires_at": "2026-03-25T12:00:00Z"
    }
  ]
}