Create an HTTP tool
Connect an agent to an API to query or modify data.
Updated August 3, 2026 · 12 minBefore 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
- Open Studio > Tools.
- Select New tool.
- Enter an action-oriented name such as
Check order status. - Explain when the agent should use it.
- 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.