Table of contents

API check defaults

Using a set of shared defaults for API checks helps you manage checks that go to the same basic endpoint, share headers and other settings.

You can set defaults for many aspects of an API request, see the separate paragraphs below. The following properties are still controlled at the check level:

• HTTP method & body
• response time limits

Use the base url to define the shared protocol, domain and path for URLs in your group’s API checks. This works as follows:

1. Set the base URL, i.e. https://api.example.com/v1
2. The base URL is now available in the {{GROUP_BASE_URL}} variable
3. In your API check, append path and query params, i.e. {{GROUP_BASE_URL}}/customers?page=1

Any headers and query parameters defined in the API check defaults are injected into each API check.

An example:

1. At the group level, you define the header X-Custom: with value 123
2. At the API check level, you define the same header X-Custom just with the value abc
3. Checkly will call your API with the X-Custom: abc header

Use the basic auth username and password to inject it into each API check in the group.

Any assertions are injected into each API check’s assertion list. Use this to always assert common response codes or headers for your API checks.

You can add setup and teardown scripts at the group level as well as the individual group level.

This is the execution flow:

1. Group level setup script
2. Check level setup script
3. Execute your API check
4. Check level teardown script
5. Group level teardown script

A common scenario for having two levels of setup scripts is the following:

1. Group level setup: Fetch a token from a common authentication endpoint.
2. Check level: prep some specific test data for this individual check.

Organizing checks with groups Environment variables and secrets at the Group level

Last updated on December 13, 2024. You can contribute to this documentation by editing this page on Github