Application

Update application

Changed on

Update an existing application

patch/applications/{id}

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/applications/{id}
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

idstring required

Application ID

Query parameters

field_maskstring[]

Comma seperated set of fields to update. If provided, only fields in the field mask will be updated. Fields in the field mask but not in the body will be set to null.

Headers

If-Matchstring

If-Match header according to http/1.1 spec section 14.24

Request body

idstring

Application ID

created_timeinteger

Time application created

created_by_idstring

ID of user who created application

last_updated_timeinteger

Time application last updated

last_updated_by_idstring

ID of user who last updated application

organization_idstring

(Deprecated, use workspace_id)

workspace_idstring

ID of workspace associated with application

namestring

Application display name

descriptionstring

Application description

send_mabl_headerboolean

Controls whether or not the x-mabl-agent header is sent on requests (can be overridden by plan and test)

execution_runner_size'x1' | 'x2' | 'x3' | 'x4' | 'x5' | 'x6' | 'small' | 'medium' | 'large' | 'inherit'

available runner sizes

enter_text_mode'fill' | 'press'

Application-level preference for how the "enter text" step types into inputs. Absent means "no preference; runtime falls back to its default."

  • fill: write the value atomically via Playwright's fill(). Fast and reliable for standard inputs.
  • press: type one character at a time. Slower, but works with autocomplete / per-character event handlers.
bypass_actionability_checksboolean

Application-level preference for whether a click step may act on an element that fails actionability checks — disabled, hidden, covered, or unstable. Affects new click steps authored in the test editor or by the Test Creation Agent. true clicks the element anyway; false fails the step when the target is not actionable. Absent means no workspace preference. Per-step overrides set in the test editor always win.

skip_javascript_fallback_clicksboolean

Application-level preference for whether a click step skips the synthetic JavaScript fallback click that normally fires when the native browser click cannot reach the target element — for example when an overlay intercepts the click or the browser routes the input away from a cross-origin iframe. true fails the step with a clear error instead of clicking synthetically; false or absent allows the fallback (the historical behavior). Newly created applications default to true.

custom_test_id_attributesstring[]

Custom HTML element attribute names mabl should prioritize when locating elements, in priority order

Response

Application updated

idstring

Application ID

created_timeinteger

Time application created

created_by_idstring

ID of user who created application

last_updated_timeinteger

Time application last updated

last_updated_by_idstring

ID of user who last updated application

organization_idstring

(Deprecated, use workspace_id)

workspace_idstring

ID of workspace associated with application

namestring

Application display name

descriptionstring

Application description

send_mabl_headerboolean

Controls whether or not the x-mabl-agent header is sent on requests (can be overridden by plan and test)

execution_runner_size'x1' | 'x2' | 'x3' | 'x4' | 'x5' | 'x6' | 'small' | 'medium' | 'large' | 'inherit'

available runner sizes

enter_text_mode'fill' | 'press'

Application-level preference for how the "enter text" step types into inputs. Absent means "no preference; runtime falls back to its default."

  • fill: write the value atomically via Playwright's fill(). Fast and reliable for standard inputs.
  • press: type one character at a time. Slower, but works with autocomplete / per-character event handlers.
bypass_actionability_checksboolean

Application-level preference for whether a click step may act on an element that fails actionability checks — disabled, hidden, covered, or unstable. Affects new click steps authored in the test editor or by the Test Creation Agent. true clicks the element anyway; false fails the step when the target is not actionable. Absent means no workspace preference. Per-step overrides set in the test editor always win.

skip_javascript_fallback_clicksboolean

Application-level preference for whether a click step skips the synthetic JavaScript fallback click that normally fires when the native browser click cannot reach the target element — for example when an overlay intercepts the click or the browser routes the input away from a cross-origin iframe. true fails the step with a clear error instead of clicking synthetically; false or absent allows the fallback (the historical behavior). Newly created applications default to true.

custom_test_id_attributesstring[]

Custom HTML element attribute names mabl should prioritize when locating elements, in priority order

Changes

  • 692fc522a990Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status