Tools

Create an HTTP tool

Connect an agent to an API to query or modify data.

Updated August 3, 2026 · 12 min

Before you begin

You need the endpoint URL, supported method, and—if protected—a credential with the least possible access. Review the API documentation first.

Create the tool

  1. Open Studio > Tools.
  2. Select New tool.
  3. Enter an action-oriented name such as Check order status.
  4. Explain when the agent should use it.
  5. Select HTTP Request.

Avoid generic names such as API or Query.

Configure the request

Select GET, POST, PUT, or DELETE and enter an absolute HTTPS URL.

GET https://api.example.com/orders

You can add URL parameters, public and secret headers, data the agent must collect, and—for non-GET methods—a base JSON body.

Save and validate

Select Create tool, review it, and use Test tool. A successful response confirms connectivity; also verify returned information and side effects.

Never test destructive operations against real data. Use a test environment or prepared resource.