Search

Using the Extension – cURL Action

Overview

cURL (short for Client URL) is a command-line tool used to transfer data over various network protocols. It communicates with web or application servers by specifying a URL along with the data to be sent or received.

The Extension – cURL Action in Functionize allows users to execute cURL commands directly within automated tests, enabling API validation and backend testing without relying on UI interactions.

Basic cURL Syntax

curl [options] [URL]

Example

curl http://worldtimeapi.org/api/timezone/America/Toronto

The server response is displayed directly in the command line or, in Functionize, in the Extension response panel.

Add an Extension – cURL Action

You can add an Extension – cURL Action to a test case using the following methods:

From the Test Detail or Slider Page

  1. Open the Test Detail page or Slider view.

  2. Click Quick Add (+) at the desired step.

  3. Select Extension under Advanced Actions.

  4. Choose cURL (default selection).

From Architect (ARC)

  1. Click the + icon on the main Architect screen.

  2. Select Extension under Advanced Actions.

  3. Choose cURL.

Execute and View Results

  • After test execution, the cURL command runs as part of the test flow.

  • The response appears in the Extensions tab located in the footer of the Slider view once execution is complete.

Using Variables in an Extension – cURL Action

Functionize supports parameterized cURL commands using variables, allowing dynamic and reusable API requests.

Variable Syntax

Use double curly brackets {{ }} to reference variables in a cURL command.

Example

curl -X POST -d '{"data": "{{myVar}}"}' https://example.com/api

Variables can be used anywhere in the cURL command, including:

  • URLs

  • Headers

  • Request bodies

  • Query parameters

Supported HTTP Methods

The Extension – cURL Action supports the following HTTP request methods:

  • GET – Retrieve data from a specified resource

  • POST – Submit data to create a resource or perform an action

  • PUT – Update or replace an existing resource

  • DELETE – Remove a specified resource

The cURL command can be entered directly into the input field without escaping quotes, similar to tools such as Postman or GitHub.

Extension – cURL Action Examples

GET Request

Retrieve a list of projects in an account.

//URL
https://app.functionize.com/api/v4/project
//HEADER
{"accept":"application/json","accesstoken":"[TOKENID]"}

POST Request

Generate an access token.

//URL
https://app.functionize.com/api/v4/generateToken
//DATA
{"apikey":"[CLIENTID]","secret":"[CLIENTSECRET]","response_type":"json"}
//HEADER
{"accept":"application/json","Content-Type":"application/x-www-form-urlencoded"}

PUT Request

Update an environment URL for a project.

//URL
https://app.functionize.com/api/v4/project/[ProjectID]/env
//DATA
{"env":"[ID]","url":"[Environment URL]","response_type":"json"}
//HEADER
{"accept":"application/json","accesstoken":"[TOKENID]","Content-Type":"application/x-www-form-urlencoded"}

DELETE Request

Delete a test.

//URL
https://app.functionize.com/api/v4/test/[TESTID]
//HEADER
{"accept":"application/json","accesstoken":"[TOKENID]"}

Extension – Postman Collection Action

Overview

Postman Collections are groups of saved API requests that can be executed directly in Functionize using the Extension – Postman Collection Action.

Add an Extension – Postman Collection Action

  1. Open the Test Details page or Slider view.

  2. Click + Insert where you want to add the action.

  3. Select Extension.

  4. Choose Postman Collection.

Configuration Options

  • Collection Type

    • File – Upload a Postman collection JSON file

    • JSON – Paste the collection JSON directly

  • Environment Variables

    • File or JSON

  • Processing Type

    • Synchronous

    • Asynchronous

  • Data File Type

    • File or JSON

  1. Click Insert to add the action.

View Postman Collection Results

  • After execution, click View on the Extension – Postman Collection Action.

  • Navigate to the Extensions tab in the footer of the Slider view.

  • The API response is displayed there.

Processing Type Behavior

  • Synchronous – The test waits for the collection execution to complete before continuing.

  • Asynchronous – The test continues execution while the collection runs in the background.

Summary

The Extension – cURL Action and Extension – Postman Collection Action provide flexible and powerful API testing capabilities in Functionize. By supporting parameterized cURL commands and Postman collections, teams can build reusable, data-driven, and scalable API tests directly within their automation workflows.