Get one test's flakiness verdict (cheap)

GET

/projects/{projectId}/tests/{testName}/status

curl --request GET \
  --url https://app.squally.dev/api/v1/projects/example/tests/example/status \
  --header 'Authorization: Bearer <token>'

The stored verdict for one test - status, active signals, labels - as of the last ingest. THE CHEAP ONE: a single lookup, no engine pass; prefer it to /flaky when the question is about one test.

Authorizations

• readKey

Parameters

Path Parameters

projectId

required

string

A project id from GET /projects.

testName

required

string

The full test name as Squally stores it (Playwright’s title path). URL-encode it, including “/” as %2F. A name used in several spec files needs ?filePath=.

Query Parameters

filePath

string

The spec file of the test, as stored (e.g. tests/checkout.spec.ts); an empty value means a test with no file. Needed only when the name exists in several files - the 400 ambiguous_test answer lists them.

Responses

200

OK

Media typeapplication/json

object

project

required

object

id

required

string

name

required

string

test

required

object

name

required

string

filePath

required

Any of:

string

string

null

null

status

required

string

Allowed values: insufficient_data healthy flaky broken

awaitingFirstWrite

required

True when the test is known but no verdict has been stored for it yet; status then reads insufficient_data.

boolean

activeSignals

required

Array<object>

object

signal

required

string

label

required

string

labels

required

Array<string>

Allowed values: flips retries

Example

{
  "status": "insufficient_data",
  "labels": [
    "flips"
  ]
}

Headers

Squally-Key-Expires-At

string format: date-time

When the read key expires (ISO-8601). Present only from 7 days before expiry.

400

Error: ambiguous_test

Media typeapplication/json

object

error

required

A sentence for a human. May be reworded.

string

code

required

Stable slug - match on this, not on the sentence.

string

Allowed values: missing_key invalid_key wrong_key_type key_revoked key_expired tier_too_low project_not_found invalid_period rate_limited test_not_found ambiguous_test internal_error invalid_parameter run_not_found error_not_found

code

required

Allowed values: ambiguous_test

Example

{
  "code": "ambiguous_test"
}

401

Error: invalid_key, key_expired, key_revoked, missing_key, wrong_key_type

Media typeapplication/json

object

error

required

A sentence for a human. May be reworded.

string

code

required

Stable slug - match on this, not on the sentence.

string

Allowed values: missing_key invalid_key wrong_key_type key_revoked key_expired tier_too_low project_not_found invalid_period rate_limited test_not_found ambiguous_test internal_error invalid_parameter run_not_found error_not_found

code

required

Allowed values: invalid_key key_expired key_revoked missing_key wrong_key_type

Example

{
  "code": "invalid_key"
}

403

Error: tier_too_low

Media typeapplication/json

object

error

required

A sentence for a human. May be reworded.

string

code

required

Stable slug - match on this, not on the sentence.

string

Allowed values: missing_key invalid_key wrong_key_type key_revoked key_expired tier_too_low project_not_found invalid_period rate_limited test_not_found ambiguous_test internal_error invalid_parameter run_not_found error_not_found

code

required

Allowed values: tier_too_low

Example

{
  "code": "tier_too_low"
}

404

Error: project_not_found, test_not_found

Media typeapplication/json

object

error

required

A sentence for a human. May be reworded.

string

code

required

Stable slug - match on this, not on the sentence.

string

Allowed values: missing_key invalid_key wrong_key_type key_revoked key_expired tier_too_low project_not_found invalid_period rate_limited test_not_found ambiguous_test internal_error invalid_parameter run_not_found error_not_found

code

required

Allowed values: project_not_found test_not_found

Example

{
  "code": "project_not_found"
}

429

Rate limited by the edge firewall. No JSON body and no Retry-After - back off for at least 60 s.

500

Error: internal_error

Media typeapplication/json

object

error

required

A sentence for a human. May be reworded.

string

code

required

Stable slug - match on this, not on the sentence.

string

Allowed values: missing_key invalid_key wrong_key_type key_revoked key_expired tier_too_low project_not_found invalid_period rate_limited test_not_found ambiguous_test internal_error invalid_parameter run_not_found error_not_found

code

required

Allowed values: internal_error

Example

{
  "code": "internal_error"
}