Skip to main content
Upcoming Mid April 2026
Base URL: https://api-staging.internal-aui.io/api/api-workflow Auth: api-key header

​
Generate Integration from cURL

Automatically generate an integration configuration from a cURL command.

​
POST /v1/api-integration/generate

​
Headers

HeaderValue
Content-Typeapplication/json
api-keyAPI workflow key

​
Request Body

​
curl
string
required
The cURL command to parse and generate an integration from.
​
scope
object
required
Scope identifiers.
​
variables
array
Variables to substitute in the cURL command.
​
tool
object
required
Tool metadata.
​
createdBy
string
required
Email of the user creating the integration.
cURL
curl -X POST "https://api-staging.internal-aui.io/api/api-workflow/v1/api-integration/generate" \
  -H "Content-Type: application/json" \
  -H "api-key: your-api-workflow-key" \
  -d '{
    "curl": "curl -X GET https://api.example.com/data -H '\''Authorization: Bearer token'\''",
    "scope": {
      "networkId": "string",
      "accountId": "string",
      "seedId": "string",
      "networkCategoryId": "string"
    },
    "variables": [],
    "tool": {
      "name": "tool_name",
      "goal": "What this tool does"
    },
    "createdBy": "user@example.com"
  }'

{
  "data": {
    "integration": {}
  }
}

​
Best Practices

  • Use complete cURL commands — Include all headers, query parameters, and request body in the cURL string. The generator parses the full command to build the integration schema.
  • Write a clear tool.goal — The goal is used by the neuro-symbolic engine to decide when to activate the tool. Be specific: “Fetch product details by SKU from the inventory API” is better than “Get data.”
  • Use variables for dynamic values — Extract API keys, user IDs, and other dynamic values into the variables array rather than hardcoding them in the cURL string. This makes the integration reusable.
  • Review generated integration before saving — The generator creates a best-effort integration config. Always review the output and adjust request/response mappings before pushing it to agent settings.
  • Prefer this over manual integration creation — The generator handles header parsing, body schema extraction, and URL decomposition automatically. It’s faster and less error-prone than building settings objects by hand.