ben/hvac-marketing-skills
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
hvac-marketing-skills/tools/integrations/airops.md
Corey Haines 9a2bb97784 fix: address codex review findings across new CLI tools 
- supermetrics: fix query endpoint /query → /query/data/json
- airops: fix base URL /v1 → /public_api/v1
- zoominfo: fix auth --dry-run leaking real JWT, add response validation
- outreach: remove parseInt() on JSON:API string IDs (caused NaN)
- similarweb: add encodeURIComponent on domain in all URL paths
- coupler: fix dry-run auth mask from '***' to 'Bearer ***'
- clay: allow name-based enrich (--first-name + --last-name + --domain)
- pendo.md: fix guide state from 'published' to 'public'
- close.md: fix rate limit header names to ratelimit-*

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 23:08:36 -08:00

2.9 KiB
Raw Blame History

AirOps

AI content platform for crafting content that wins AI search. Build and execute AI workflows (flows) for SEO content generation, data enrichment, and automation.

Capabilities

Integration Available Notes
API ✓ Flows, Workflows, Runs
MCP - Not available
CLI ✓ airops.js
SDK - REST API only

Authentication

  • Type: API Key + Workspace ID
  • Header: Authorization: Bearer {api_key}
  • Env vars: AIROPS_API_KEY, AIROPS_WORKSPACE_ID
  • Get key: Settings > API Keys at https://app.airops.com

Common Agent Operations

List Flows

GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows

Get Flow Details

GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}

Execute a Flow

POST https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}/execute

{
  "inputs": {
    "keyword": "best project management tools",
    "target_audience": "startup founders"
  }
}

List Runs for a Flow

GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/flows/{flow_id}/runs

Get Run Status

GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/runs/{run_id}

List Workflows

GET https://api.airops.com/public_api/v1/workspaces/{workspace_id}/workflows

Execute a Workflow

POST https://api.airops.com/public_api/v1/workspaces/{workspace_id}/workflows/{workflow_id}/execute

{
  "inputs": {
    "topic": "email marketing best practices",
    "content_type": "blog_post"
  }
}

Key Metrics

Flow Data

  • id - Flow identifier
  • name - Flow name
  • description - Flow description
  • status - Active/inactive status
  • created_at - Creation timestamp
  • updated_at - Last modified timestamp

Run Data

  • id - Run identifier
  • flow_id - Parent flow ID
  • status - pending, running, completed, failed
  • inputs - Input parameters used
  • outputs - Generated results
  • started_at - Run start time
  • completed_at - Run completion time

Parameters

Flow Execution

  • inputs - JSON object of key-value pairs matching the flow's expected inputs
  • Input keys vary per flow (e.g., keyword, topic, url, target_audience)

Workflow Execution

  • inputs - JSON object of key-value pairs matching the workflow's expected inputs

When to Use

  • Bulk content generation for SEO at scale
  • SEO-optimized article creation with AI workflows
  • Data enrichment pipelines for marketing lists
  • Keyword research automation
  • Content optimization and rewriting
  • Programmatic SEO page generation
  • AI-powered content briefs and outlines

Rate Limits

  • Rate limits vary by plan
  • Concurrent execution limits depend on workspace tier
  • Check AirOps dashboard for current usage and limits

Relevant Skills

  • ai-seo
  • content-strategy
  • programmatic-seo
  • copywriting