---
title: "Pause test run"
method: POST
path: "/api/apps/{app_id}/testing-agent/executions/{execution_id}/pause"
---

# Pause test run

`POST /api/apps/{app_id}/testing-agent/executions/{execution_id}/pause`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/testing-agent/executions/{execution_id}/pause`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Stops a test run that's `pending` or `running` and closes its browser session. The run ends with `status` set to `paused` and no `failure_reason`, which is how you tell it apart from a run paused for running out of credits. It gets no report. A paused run can't be resumed, so [run the test](/api-reference/run-test) again to start over.

A run that's already `analyzing` isn't paused, because its browser session is over. The call returns `already_terminal` set to `true` and the run goes on to get its report. A run that already ended also returns `already_terminal` set to `true`, so retrying is safe.

This is limited to 300 requests per minute per caller for each app. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. Read-only keys and workspace API keys are refused.</Note>

## Path parameters

- `app_id` string, required: ID of the app.
- `execution_id` string, required: ID of the run to pause.

## Response `200`

The run is paused, or nothing changed.

- PauseTestRunResult: The result of pausing a run.
  - `success` boolean, required: Always `true`.
  - `already_terminal` boolean, nullable: `true` when nothing changed: the run had already ended, or it was `analyzing`. Left out when the run was paused.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have editor access to this app, the app is blocked, or your API key is read-only or a workspace API key.
- `404`: App or run not found.
- `409`: Your workspace requires an unlocked SSO session.
- `429`: Rate limit exceeded.

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-06** `dddf17e0f9f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/testing-agent/executions/:execution_id/pause/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)