Creating API requests

Use the step builder in the API Test Editor to create, configure, and send requests to the API under test.

Building a request in the step builder 

To create a new API request, click on the + Add step button and enter the following information into the Request details section: 

1. Give the request a name. Naming requests helps other members of your workspace understand the purpose of the request.
2. Select an HTTP method: GET, POST, PUT, PATCH, FETCH, DELETE, HEAD, or OPTIONS.
3. Enter the URL. Use mabl variable syntax to reference the base URL: api.url. For example, if the api.url is https://example.com/api and you want to make a request to https://example.com/api/users, enter {{@api.url}}/users in the URL field.
4. Use the following tabs to configure any additional settings that the API requires, including:
   • Auth - send authentication or authorization settings with your API request
   • Params - append params as key-value pairs to the API URL
   • Headers - enter request headers as key-value pairs
   • Body - add or update data, including uploading files.
   • Pre-request - run JavaScript code before the request is made. See the article on adding scripts for more details.
   • Settings - apply settings to the request as key-value pairs

After you enter the request details, click on the Send button to test out the request. The API Test Editor shows the response details in the Results section.

Next steps

After creating a request, use the Validation and variable assignment section to make assertions and create variables from the response of an API step.