CHchecklyhq
Test sessions

Await the completion of a test session

Changed on

Call this endpoint to await the completion of a test session. A successful response code will be returned once the test session reaches its final state (i.e. when it passes or fails).

If the test session takes a long time to complete, the endpoint will return a timeout error code. You should keep calling the endpoint until you receive a successful response, or a non-timeout related error code. If using curl, its --retry option is suitable.

The successful response of this endpoint is equivalent to the GET /v1/test-sessions/{testSessionId} endpoint's response for a completed test session.

get/v1/test-sessions/{testSessionId}/completion

Request

Path parameters

testSessionIdstring uuid required

Test session ID.

Query parameters

maxWaitSecondsnumber

Maximum time to wait for completion before returning a retryable timeout response.

Headers

x-checkly-accountstring uuid

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Response

Successful

testSessionIdstring uuid required
testSessionLinkstring uri required
namestring required
status'FAILED' | 'PASSED' | 'CANCELLED' required
errorGroupIdsstring[] required

IDs of the test-session error groups observed in this test session.

startedAtstring date-time required
stoppedAtstring date-time required
timeElapsednumber required

Changes

  • bc90d1bfa738Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • a4fea1ad9b9aRevision changes
    • warning

      added the new GRPC enum value to the // response property for the response status

    • warning

      added the new SSL enum value to the // response property for the response status

    • warning

      added the new TRACEROUTE enum value to the // response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status