External API integration
High-level steps to expose your systems to agents as tools over REST.
Steps
- Create an integration (base URL + auth).
- Define one or more endpoints (method, path, schemas).
- Create a tool linked to that integration (
apiIntegrationId). - Link the tool to the relevant agent.
- Test the endpoint for live validation.
Authentication types
| Type | When? |
|---|---|
none | Public or internal network |
api_key | Simple API key |
bearer | OAuth / JWT bearer |
basic | Username/password |
oauth2 | Authorization server flow |