Create Connector Actions as Components
Use this mode to convert a vendor's API specification into individual Turbine components, one per endpoint. You can then use these components in playbooks or reference them in the ingestion process.
At the top of the widget, under Select what you would like to create, choose Connector Actions (the other option is Ingestion). Use Start from beginning to reset the process at any time.
Step 1: API Specification
Upload or paste an OpenAPI spec to discover available endpoints.
- In the API Specification area, either paste your API/Swagger specification (JSON or YAML) into the text area or use Choose File to upload a file.
- Optionally check Skip deprecated endpoints to exclude deprecated endpoints from the next step.
- Select Parse OpenAPI Spec to read the specification and discover endpoints.
Step 2: Select endpoints
Select the API endpoints you want to turn into reusable components.
- The widget lists available endpoints (after parsing in Step 1). A badge shows how many are selected (for example, 0 Selected).
- Select the checkbox next to each endpoint you want to create a component for. You can select up to 25 endpoints; once this limit is reached, the remaining endpoint checkboxes are disabled.
- Select Continue to proceed.
If you have not parsed the spec yet, the widget shows Please parse the OpenAPI spec first to see available endpoints.
Step 3: Authentication configuration
Set up the authentication required to access the vendor API.
- Under Authentication Type, choose one: None, API Key, Bearer Token, Basic Auth, or OAuth 2.0. The widget can prefill the type from the specification; for None, no authentication is needed.
- Create a new HTTP asset or Select an existing asset and configure credentials as needed. The widget names a new asset ProductName Asset, where ProductName is from the specification.
- Select Continue.
Step 4: Test endpoints
Test your credentials against a selected GET endpoint to verify access.
- From the Endpoint dropdown, select an endpoint.
- Select Test Endpoint to run the request with your configured authentication.
- Select Continue when done.
Only GET endpoints that you selected in Step 2 appear in the dropdown. If none were selected, the widget shows No GET endpoints available. Please select GET endpoints first.
Step 5: Generate components
Configure additional settings and generate the components.
- Under Additional settings for component:
- Component Prefix β Prefix for generated component names (defaults to the product name from the specification).
- Base URL β Base URL for API calls (for example, https://api.panoraysapp.com).
- Under Hero AI:
- Visible to Hero AI β When enabled, the generated components are available to Hero AI.
- Requires confirmation to execute in chat β When enabled, Hero AI must get confirmation before executing these components in chat.
- Select Generate components.
Turbine generates one component per selected endpoint. Components are named ComponentPrefix EndpointName (for example, CrowdStrike Falcon Get Alerts). Each component name in the widget is a hyperlink to the component.