Skip to main content

What is Import cURL in the Agent Studio API Call Tool?

Import cURL in the Agent Studio API Call Tool lets you paste a cURL command and automatically convert it into an API Call configuration inside Kyrios.

Where Import cURL Works

Import cURL is available inside the API Call tool configuration panel in Agent Studio.

To access Agent Studio:

  1. Go to AI Agents

  2. Click Agent Studio

You can then create a new agent or open an existing one.

Import cURL can be used inside:

  • An AI Agent node

  • A Sequential node

What Import cURL Automatically Populates

Import cURL extracts request details from the pasted cURL command and fills the API Call configuration automatically. Import cURL can populate:

  1. HTTP method

  2. API endpoint URL

  3. Headers

  4. Request body

Supported body types include:

  • JSON

  • HTML

  • XML

  • Text

  • Form Data

Supported cURL patterns include:

  • --location redirects

  • -u basic authentication

  • Multiline request bodies

  • Backslash \ line continuations

How To Use Import cURL

  1. Navigate to AI Agents > Agent Studio

  2. Create a new agent or open an existing agent

  3. Add or select a start trigger

  4. Add an AI Agent node or Sequential node

  5. Add the API Call tool

  6. Open the API Call configuration panel

  7. Click Import cURL

  8. Paste your cURL command

  9. Click Import

  10. Review the imported configuration

  11. Click Save

  12. Test the API Call

  13. Publish the agent

This workflow demonstrates how the API Call tool is added inside a Sequential node before configuring and importing the cURL request.

Fields to Review After Importing

Always review imported API settings before saving or publishing the agent.

Review these fields carefully:

Instructions

Describe what the API Call does and when the AI Agent should use it.

Variable Name

Confirm where the API response data will be stored.

API Endpoint

Verify both:

  • HTTP method

  • Endpoint URL

Headers

Confirm required headers such as:

  • Authorization

  • Content-Type

  • API Keys

Request Body

Review the imported payload and body format.

Authentication Values

Replace or secure any:

  • Tokens

  • Credentials

  • API keys

Variables

Add Agent Studio variables when dynamic runtime values are needed.

Examples include:

  • Contact fields

  • Conversation data

  • Workflow values

  • Runtime variables

Two-Way Sync With cURL

The Import cURL modal also supports two-way synchronization. When reopening the Import cURL modal, Kyrios reconstructs the current API Call configuration into a cURL command automatically. This helps when you need to:

  1. Verify request formatting

  2. Compare against external API documentation

  3. Troubleshoot requests

  4. Edit headers or request body content quickly

API Call Tool vs. Agent Studio Public APIs

The API Call Tool and Agent Studio Public APIs serve different purposes.

API Call Tool

The API Call Tool allows an AI Agent to make an external API request while the agent flow is running. Example:

  • Retrieve external data

  • Send data to another platform

  • Trigger an external process

Agent Studio Public APIs

Agent Studio Public APIs allow external applications to interact with Agent Studio agents programmatically. Example:

  • List agents

  • Execute agents externally

  • Retrieve production agent data

Use the API Call Tool when the agent needs to call an external service during execution. Use Agent Studio Public APIs when an outside application needs to interact with Agent Studio.

Common Issues and Fixes

The imported request does not work

Review:

  • Endpoint URL

  • HTTP method

  • Headers

  • Authorization values

  • Request body

  • Body type

  • Variables

Then test the agent again.

Authentication fails after importing

Check whether the imported cURL command contains expired:

  • Tokens

  • API keys

  • Basic authentication credentials

Replace them before testing.

The request body imports incorrectly

Verify the detected body type. Adjust the body format manually if necessary.

The API response is unavailable later in the flow

Check the Variable Name field to confirm the API response is being stored properly.

FAQ

What does Import cURL do?

Import cURL converts a pasted cURL command into API Call configuration fields such as the HTTP method, endpoint URL, headers, and request body.

Can I edit the API Call after importing?

Yes. All imported fields remain editable after import.

Does Import cURL support multiline commands?

Yes. Import cURL supports multiline request bodies and backslash line continuations.

What body types can Import cURL detect?

Import cURL supports:

  • JSON

  • HTML

  • XML

  • Text

  • Form Data

Can I use variables after importing?

Yes. You can add supported Agent Studio variables after the cURL command is imported.

Should I test the API Call before publishing?

Yes. Always test the API Call before publishing the agent.

Is Import cURL the same as Agent Studio Public APIs?

No. Import cURL helps configure API requests inside an agent flow. Agent Studio Public APIs allow external systems to interact with Agent Studio programmatically.

Related Articles
Workflow Action: Log External Call
Did this answer your question?