{
  "method": "published",
  "provider": "JobsPipe",
  "description": "How an AI agent may call each JobsPipe API operation: whether it only reads, whether it changes the caller's account, whether a person must approve it, and what it costs. Authentication is an API key (Authorization: Bearer) or an OAuth access token from https://api.jobspipe.dev.",
  "source": "https://jobspipe.dev/openapi.json",
  "summary": {
    "operations": 40,
    "read": 31,
    "write": 8,
    "financial": 1,
    "human_in_the_loop_required": 1
  },
  "operations": [
    {
      "path": "/v1/jobs/search",
      "method": "post",
      "operationId": "searchJobs",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes 1 credit from the caller's monthly quota per job returned that the account has not already paid for this calendar month"
      }
    },
    {
      "path": "/v1/jobs/export",
      "method": "get",
      "operationId": "exportJobsGet",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per job in the file that the account has not already paid for this calendar month, settled when the file ends for the rows sent; stops early when the credits run out"
      }
    },
    {
      "path": "/v1/jobs/export",
      "method": "post",
      "operationId": "exportJobs",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per job in the file that the account has not already paid for this calendar month, settled when the file ends for the rows sent; stops early when the credits run out"
      }
    },
    {
      "path": "/v1/jobs/export/estimate",
      "method": "post",
      "operationId": "estimateJobsExport",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none; free"
      }
    },
    {
      "path": "/v1/jobs/agentic-search",
      "method": "post",
      "operationId": "agenticSearchJobs",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes 1 credit from the caller's monthly quota per job returned that the account has not already paid for this calendar month; candidates considered but not returned cost nothing"
      }
    },
    {
      "path": "/v1/stack/scan",
      "method": "post",
      "operationId": "scanStack",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "stack:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "may trigger a fresh scan of the target domain and refresh the ~14-day cache; consumes 1 credit"
      }
    },
    {
      "path": "/v1/enrich/email",
      "method": "post",
      "operationId": "enrichEmail",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes credits for each contact found and not revealed before by this account; misses, cached reveals and errors cost nothing"
      }
    },
    {
      "path": "/v1/enrich/phone",
      "method": "post",
      "operationId": "enrichPhone",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes credits for each contact found and not revealed before by this account; misses, cached reveals and errors cost nothing"
      }
    },
    {
      "path": "/v1/companies/{key}",
      "method": "get",
      "operationId": "getCompany",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit when the record is returned; a 404 costs nothing"
      }
    },
    {
      "path": "/v1/companies/suggest",
      "method": "get",
      "operationId": "suggestCompanies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes no credits"
      }
    },
    {
      "path": "/v1/companies/search",
      "method": "post",
      "operationId": "searchCompaniesByTechnology",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per company returned that the account has not already paid for this calendar month"
      }
    },
    {
      "path": "/v1/companies/{key}/technologies",
      "method": "get",
      "operationId": "getCompanyTechnologies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit when technologies are returned; a 404 costs nothing"
      }
    },
    {
      "path": "/v1/technologies",
      "method": "get",
      "operationId": "listTechnologies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit"
      }
    },
    {
      "path": "/v1/technologies/export",
      "method": "get",
      "operationId": "exportTechnologies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per call plus 1 per company in the file that the account has not already paid for this calendar month, settled once the data is ready and before the download starts"
      }
    },
    {
      "path": "/v1/technologies/resolve",
      "method": "post",
      "operationId": "resolveTechnologies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none; free"
      }
    },
    {
      "path": "/v1/technologies/{slug}",
      "method": "get",
      "operationId": "getTechnology",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit"
      }
    },
    {
      "path": "/v1/monitors",
      "method": "get",
      "operationId": "listMonitors",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors",
      "method": "post",
      "operationId": "createMonitor",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "deleteMonitor removes it",
        "cost": "creates a monitor - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/by-external-id/{external_id}",
      "method": "put",
      "operationId": "upsertMonitor",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "upsertMonitor again with the previous body; dry_run=true previews it",
        "cost": "creates or updates a monitor - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}",
      "method": "get",
      "operationId": "getMonitor",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}",
      "method": "delete",
      "operationId": "deleteMonitor",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "restoreMonitor brings it back within 30 days; dry_run=true previews the delete",
        "cost": "deletes the monitor; restorable for 30 days - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}/restore",
      "method": "post",
      "operationId": "restoreMonitor",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "deleteMonitor deletes it again",
        "cost": "undeletes a monitor - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}/renew",
      "method": "post",
      "operationId": "renewMonitor",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "renewMonitor again sets any other expiry",
        "cost": "extends the monitor - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}/ids",
      "method": "get",
      "operationId": "listMonitorIds",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}/ids",
      "method": "post",
      "operationId": "addMonitorIds",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "removeMonitorIds takes the records out again",
        "cost": "adds records - consumes no credits"
      }
    },
    {
      "path": "/v1/monitors/{id}/ids",
      "method": "delete",
      "operationId": "removeMonitorIds",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "addMonitorIds puts the records back; dry_run=true previews the removal",
        "cost": "removes records - consumes no credits"
      }
    },
    {
      "path": "/v1/account",
      "method": "get",
      "operationId": "getAccount",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes no credits"
      }
    },
    {
      "path": "/v1/feedback",
      "method": "post",
      "operationId": "submitFeedback",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "write",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "reversibility": "not reversible; a person reads it",
        "cost": "none - consumes no credits and takes no rate-limit slot"
      }
    },
    {
      "path": "/v1/billing/checkout",
      "method": "post",
      "operationId": "createBillingCheckout",
      "x-agentic-access": {
        "action-class": "acting",
        "consequence": "financial",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "required"
        },
        "reversibility": "the call charges nothing; only the account holder can pay on the checkout page it returns",
        "cost": "none until the account holder pays - the call itself charges nothing and consumes no credits"
      }
    },
    {
      "path": "/v1/insights/salary/benchmark",
      "method": "post",
      "operationId": "insightsSalaryBenchmark",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none - consumes 1 credit from the caller's monthly quota per job returned that the account has not already paid for this calendar month"
      }
    },
    {
      "path": "/v1/sandbox/jobs/search",
      "method": "post",
      "operationId": "sandboxSearchJobs",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "none",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none"
      }
    },
    {
      "path": "/v1/sandbox/jobs/search/batch",
      "method": "post",
      "operationId": "sandboxSearchJobsBatch",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "none",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none"
      }
    },
    {
      "path": "/v1/sandbox/jobs/export",
      "method": "post",
      "operationId": "sandboxCreateExport",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "none",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none"
      }
    },
    {
      "path": "/v1/sandbox/jobs/export/{id}",
      "method": "get",
      "operationId": "sandboxGetExport",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "none",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none"
      }
    },
    {
      "path": "/v1/jobs/companies",
      "method": "post",
      "operationId": "searchHiringCompanies",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per company returned that the account has not already paid for this calendar month; parent entities without jobs of their own and empty pages are free"
      }
    },
    {
      "path": "/v1/jobs/companies/{key}",
      "method": "get",
      "operationId": "getCompanyProfile",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per company page; a company already paid for this calendar month (here or by the companies list) is free, and a company that is not found or has no postings costs nothing"
      }
    },
    {
      "path": "/v1/jobs/companies/{key}/summary",
      "method": "post",
      "operationId": "summarizeCompanyProfile",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes no credits"
      }
    },
    {
      "path": "/v1/layoffs",
      "method": "get",
      "operationId": "searchLayoffs",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [
          "jobs:read"
        ],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "consumes 1 credit per notice returned; a notice already paid for this calendar month is free, and an empty page costs nothing"
      }
    },
    {
      "path": "/v1/live/sources",
      "method": "get",
      "operationId": "listLiveSources",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "none; consumes no credits"
      }
    },
    {
      "path": "/v1/live/{source}",
      "method": "post",
      "operationId": "fetchLive",
      "x-agentic-access": {
        "action-class": "connected",
        "consequence": "read",
        "subject": "required",
        "scope": [],
        "escalation": {
          "human-in-the-loop": "none"
        },
        "cost": "fetches from the source at call time; consumes no credits"
      }
    }
  ]
}