Saber

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "full_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "Joey van Ommen",
          "description": "Full name of the contact. Accepts 2-3 token names\n(`Joey Ommen`, `Joey Tobias Ommen`) and 3-4 token\nnames where the middle tokens form a recognized\nEuropean name particle (`Joey van Ommen`,\n`Joey van der Ommen`). Single-token names and names\nlonger than 4 tokens are rejected with 422.\n"
        },
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "example": "saber.app",
          "description": "The mail domain for the contact's company. Accepts\nbare domains (`saber.app`), domains with `www.`\nprefix, and trailing-dot forms. URL-shaped inputs\n(`https://saber.app`) and email-shaped inputs\n(`joey@saber.app`) are rejected with 422.\n"
        }
      },
      "required": [
        "full_name",
        "domain"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "contacts": {
          "minItems": 1,
          "maxItems": 1000,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "full_name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200,
                "description": "Same semantics as the single find-email endpoint."
              },
              "domain": {
                "type": "string",
                "minLength": 1,
                "maxLength": 253,
                "description": "Same semantics as the single find-email endpoint."
              }
            },
            "required": [
              "full_name",
              "domain"
            ],
            "additionalProperties": {}
          }
        }
      },
      "required": [
        "contacts"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The `batch_id` returned by the submit call."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")."
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook to receive the completed signal. Intended for the\nasync endpoints; if supplied on a synchronous `/sync/` endpoint the\nwebhook is still delivered, in addition to the blocking response.\n"
        },
        "forceRefresh": {
          "default": false,
          "description": "Force a fresh run. By default an identical request (same domain and\nparameters) returns the existing result instead of re-running; set\nthis to `true` to bypass that and research again.\n",
          "type": "boolean"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")."
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook to receive the completed signal. Intended for the\nasync endpoints; if supplied on a synchronous `/sync/` endpoint the\nwebhook is still delivered, in addition to the blocking response.\n"
        },
        "forceRefresh": {
          "default": false,
          "description": "Force a fresh run. By default an identical request (same domain and\nparameters) returns the existing result instead of re-running; set\nthis to `true` to bypass that and research again.\n",
          "type": "boolean"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")."
        },
        "category": {
          "type": "string",
          "enum": [
            "erp",
            "crm"
          ],
          "example": "crm",
          "description": "A coarse technology category to survey. Mutually exclusive with\n`technology`.\n"
        },
        "technology": {
          "type": "string",
          "example": "salesforce",
          "description": "A specific technology to check for, given as free text (e.g.\n\"salesforce\", \"SAP S/4HANA\"); Saber resolves it to a canonical\nregistry slug. An unresolvable value returns 422 with did-you-mean\nsuggestions. Mutually exclusive with `category`.\n"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook to receive the completed signal. Intended for the async endpoint; if supplied on the synchronous `/sync/` endpoint the webhook is still delivered, in addition to the blocking response."
        },
        "forceRefresh": {
          "default": false,
          "description": "Force a fresh run. By default an identical request (same domain and\nparameters) returns the existing result instead of re-running; set\nthis to `true` to bypass that and research again.\n",
          "type": "boolean"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")."
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook to receive the completed signal. Intended for the\nasync endpoints; if supplied on a synchronous `/sync/` endpoint the\nwebhook is still delivered, in addition to the blocking response.\n"
        },
        "forceRefresh": {
          "default": false,
          "description": "Force a fresh run. By default an identical request (same domain and\nparameters) returns the existing result instead of re-running; set\nthis to `true` to bypass that and research again.\n",
          "type": "boolean"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")."
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook to receive the completed signal. Intended for the\nasync endpoints; if supplied on a synchronous `/sync/` endpoint the\nwebhook is still delivered, in addition to the blocking response.\n"
        },
        "forceRefresh": {
          "default": false,
          "description": "Force a fresh run. By default an identical request (same domain and\nparameters) returns the existing result instead of re-running; set\nthis to `true` to bypass that and research again.\n",
          "type": "boolean"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
      "description": "Filter signals by company domain (e.g., \"acme.com\")"
    },
    "companyId": {
      "type": "string",
      "description": "Filter signals by company ID"
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "fromDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "Filter signals completed on or after this date (RFC3339 format)"
    },
    "toDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "Filter signals completed on or before this date (RFC3339 format)"
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "processing",
          "completed",
          "failed"
        ]
      },
      "description": "Filter by signal status (can be specified multiple times for multiple statuses)"
    },
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Filter signals by subscription ID (UUID of the signal subscription that triggered execution)"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to research (e.g., \"acme.com\")"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "example": "What is Acme Corp's main business focus?",
          "description": "The research question to ask about the company"
        },
        "answerType": {
          "default": "open_text",
          "example": "open_text",
          "description": "The expected format of the answer",
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contacts_generation",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ]
        },
        "outputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "example": {
            "type": "object",
            "properties": {
              "pricingTiers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "price": {
                      "type": "number"
                    },
                    "features": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "name"
                  ]
                }
              },
              "hasFreeTier": {
                "type": "boolean"
              }
            },
            "required": [
              "pricingTiers"
            ]
          },
          "description": "JSON Schema defining the expected output structure. Required when answerType is \"json_schema\".\nThe AI will generate data conforming to this schema.\n\n**Supported JSON Schema features:**\n- `type`: object, array, string, number, integer, boolean, null\n- `properties`: Define object properties\n- `required`: List of required property names\n- `items`: Schema for array items\n- `enum`: Enumeration of allowed values\n- `description`: Property descriptions (helps AI generate better data)\n\n**Limitations:**\n- Maximum 100 total properties\n- Maximum 5 levels of nesting\n- `anyOf`, `oneOf`, `allOf` are not supported\n- `$ref` only supports self-references for recursive schemas\n"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook URL to receive notifications when processing completes.\nWebhooks are only sent for freshly processed signals — cached results do not trigger webhooks.\nSet `forceRefresh: true` to bypass the cache and ensure webhook delivery.\n"
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "example": "important",
          "description": "The importance/weight of the signal"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Qualification criteria mapping answer values based on answerType. The structure must match the answerType specified.\n\nFor boolean answerType:\n```json\n{\n  \"yes\": \"good\",\n  \"no\": \"disqualified\"\n}\n```\n\nFor number, percentage, or currency answerType:\n```json\n{\n  \"ranges\": [\n    { \"rangeStart\": 0, \"rangeEnd\": 100, \"answerValue\": \"neutral\" },\n    { \"rangeStart\": 101, \"rangeEnd\": 1000, \"answerValue\": \"good\" }\n  ]\n}\n```\n\nFor list answerType:\n```json\n{\n  \"choices\": {\n    \"salesforce\": { \"answerValue\": \"good\", \"label\": \"Salesforce\" },\n    \"hubspot\": { \"answerValue\": \"neutral\", \"label\": \"HubSpot\" },\n    \"none\": { \"answerValue\": \"disqualified\", \"label\": \"No CRM\" }\n  }\n}\n```\n\nValid answerValue options (from worst to best):\n- disqualified: Answer indicates a deal-breaker or disqualifying factor\n- poor: Answer indicates a weak fit\n- neutral: Answer is acceptable but not ideal\n- good: Answer indicates a strong fit\n- excellent: Answer indicates an exceptional fit\n"
        },
        "signalTemplateId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
          "example": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
          "description": "Optional signal template ID to use. When provided, the template configuration (question, answerType, weight, qualificationCriteria) will be used.\nThe system always resolves to the latest active version of the template.\nOnly the domain parameter is required when using a template.\n"
        },
        "forceRefresh": {
          "default": false,
          "example": false,
          "description": "Force re-run of the signal analysis, skipping the cache. When set to true, a new signal will be created even if a cached result exists.",
          "type": "boolean"
        },
        "connectors": {
          "type": "object",
          "properties": {
            "salesNavigator": {
              "type": "object",
              "properties": {
                "enabled": {
                  "default": "preferred",
                  "example": "preferred",
                  "description": "Controls Sales Navigator usage during signal generation:\n- **required**: Fail request if Sales Navigator unavailable (rate limited/disconnected)\n- **preferred**: Attempt Sales Navigator, degrade gracefully if unavailable (default)\n- **off**: Do not attempt Sales Navigator\n",
                  "type": "string",
                  "enum": [
                    "required",
                    "preferred",
                    "off"
                  ]
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {},
          "description": "Connector configuration for signal generation"
        },
        "verificationMode": {
          "default": "strict",
          "example": "strict",
          "description": "Controls how strictly Saber verifies answers before responding.\n\n- **strict**: Only returns answers backed by verified sources (primary or trusted secondary sources). Returns null when information is unavailable.\n- **lenient**: Allows logical inference and best-effort estimates when direct evidence is missing. Uses industry benchmarks, logical correlates, and quantitative metrics.\n",
          "type": "string",
          "enum": [
            "strict",
            "lenient"
          ]
        }
      },
      "required": [
        "domain",
        "question"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "signals": {
          "minItems": 1,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "question": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500,
                "example": "What is their main product offering?",
                "description": "The research question. Required if templateId is not provided.\nIf templateId is provided, this overrides the template's question.\n"
              },
              "templateId": {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
                "example": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
                "description": "ID of the signal template to use. If provided, other fields (except question) use template settings."
              },
              "answerType": {
                "type": "string",
                "enum": [
                  "open_text",
                  "number",
                  "boolean",
                  "list",
                  "percentage",
                  "currency",
                  "url",
                  "contacts",
                  "contact_posts",
                  "json_schema"
                ],
                "example": "open_text",
                "description": "Expected answer format (only used for inline signals without templateId)"
              },
              "outputSchema": {
                "type": "object",
                "properties": {},
                "additionalProperties": {},
                "description": "JSON Schema for custom output (only used when answerType is json_schema)"
              },
              "weight": {
                "type": "string",
                "enum": [
                  "important",
                  "nice_to_have",
                  "not_important"
                ],
                "example": "important",
                "description": "Signal importance (only used for inline signals without templateId)"
              },
              "qualificationCriteria": {
                "type": "object",
                "properties": {},
                "additionalProperties": {},
                "description": "Qualification criteria for the answer (only used for inline signals without templateId)"
              },
              "webhookUrl": {
                "type": "string",
                "maxLength": 2048,
                "format": "uri",
                "example": "https://myapp.com/webhooks/signals",
                "description": "URL to receive a webhook notification when the signal completes processing.\nWebhooks are only sent for freshly processed signals — cached results do not trigger webhooks.\nSet `forceRefresh: true` to bypass the cache and ensure webhook delivery.\n"
              },
              "forceRefresh": {
                "default": false,
                "example": false,
                "description": "When true, bypasses the signal cache and forces fresh processing.\nThis ensures the webhook is delivered even if a cached result exists.\n",
                "type": "boolean"
              }
            },
            "additionalProperties": {}
          },
          "description": "Array of signals to create. Each signal will be combined with each domain\nusing Cartesian product logic. You can either:\n- Provide inline signal configuration with `question` and optional fields (quick ad-hoc research)\n- Use `templateId` to reference a pre-created template (recommended for reusability)\n"
        },
        "domains": {
          "minItems": 1,
          "maxItems": 100,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 253,
            "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
            "example": "acme.com",
            "description": "Company domain (e.g., \"acme.com\")"
          },
          "description": "Array of company domains to research. Each domain will be combined with each signal template\nusing Cartesian product logic. The total resulting signals (len(signals) × len(domains)) must not exceed 100.\n"
        },
        "generateSummaryOnComplete": {
          "default": false,
          "example": false,
          "description": "Whether to automatically generate a summary when all signals in the batch are completed.\nWhen set to `true`, a summary will be automatically generated for each unique domain in the batch\nonce all signals for that domain have completed processing.\n",
          "type": "boolean"
        },
        "async": {
          "default": false,
          "example": false,
          "description": "When `true`, enables async processing with a higher limit of 20,000 signals.\nReturns a `batchId` for tracking instead of inline results.\nThe response shape differs from sync mode — returns `{ batchId, submittedAt, totalSignals, status, async }`.\nUse `/v1/companies/signals/batches/status?domain=...` to poll for progress.\n",
          "type": "boolean"
        }
      },
      "required": [
        "signals",
        "domains"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "contactProfileUrl": {
      "type": "string",
      "format": "uri",
      "description": "Filter signals by contact profile URL (LinkedIn or other professional profile)"
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "contactProfileUrl": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "format": "uri",
          "example": "https://linkedin.com/in/johndoe",
          "description": "The contact profile URL to research (e.g., \"https://linkedin.com/in/johndoe\")"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "example": "What are this person's main professional interests?",
          "description": "The research question to ask about the contact"
        },
        "answerType": {
          "default": "open_text",
          "example": "open_text",
          "description": "The expected format of the answer",
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contacts_generation",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ]
        },
        "outputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "JSON Schema defining the expected output structure. Required when answerType is \"json_schema\".\nSee CreateSignalRequest.outputSchema for full documentation.\n"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/signals",
          "description": "Optional webhook URL to receive notifications when processing completes.\nWebhooks are only sent for freshly processed signals — cached results do not trigger webhooks.\nSet `forceRefresh: true` to bypass the cache and ensure webhook delivery.\n"
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "example": "important",
          "description": "The importance/weight of the signal"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Qualification criteria mapping answer values based on answerType (same structure as company signals)"
        },
        "signalTemplateId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
          "example": "a12b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
          "description": "Optional signal template ID to use"
        },
        "connectors": {
          "type": "object",
          "properties": {
            "salesNavigator": {
              "type": "object",
              "properties": {
                "enabled": {
                  "default": "preferred",
                  "example": "preferred",
                  "description": "Controls Sales Navigator usage during signal generation:\n- **required**: Fail request if Sales Navigator unavailable (rate limited/disconnected)\n- **preferred**: Attempt Sales Navigator, degrade gracefully if unavailable (default)\n- **off**: Do not attempt Sales Navigator\n\nNote: Contact signals always require LinkedIn, so this setting is accepted but ignored for contact signals.\n",
                  "type": "string",
                  "enum": [
                    "required",
                    "preferred",
                    "off"
                  ]
                }
              },
              "additionalProperties": {}
            }
          },
          "additionalProperties": {},
          "description": "Connector configuration for signal generation"
        },
        "verificationMode": {
          "default": "strict",
          "example": "strict",
          "description": "Controls how strictly Saber verifies answers before responding.\n\n- **strict**: Only returns answers backed by verified sources (primary or trusted secondary sources). Returns null when information is unavailable.\n- **lenient**: Allows logical inference and best-effort estimates when direct evidence is missing. Uses industry benchmarks, logical correlates, and quantitative metrics.\n",
          "type": "string",
          "enum": [
            "strict",
            "lenient"
          ]
        },
        "forceRefresh": {
          "default": false,
          "example": false,
          "description": "Force re-run of the signal analysis, skipping the cache. When set to true, a new signal will be created even if a cached result exists.",
          "type": "boolean"
        }
      },
      "required": [
        "contactProfileUrl",
        "question"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "signalId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The unique identifier of the signal (UUID format)"
    }
  },
  "required": [
    "signalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The UUID of the signal subscription"
    },
    "domain": {
      "type": "string",
      "description": "Filter signals by company domain"
    },
    "companyId": {
      "type": "string",
      "description": "Filter signals by company ID"
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of results per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "fromDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "Filter signals completed on or after this date (RFC3339 format)"
    },
    "toDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
      "description": "Filter signals completed on or before this date (RFC3339 format)"
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "processing",
          "completed",
          "failed"
        ]
      },
      "description": "Filter by signal status (can be specified multiple times)"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "signalId": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The unique identifier of the contact signal (UUID format)"
    }
  },
  "required": [
    "signalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "externalId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The external identifier of the contact research request (e.g., HubSpot contact ID)"
    },
    "externalSource": {
      "type": "string",
      "minLength": 1,
      "maxLength": 50,
      "description": "The source system that provided the external ID (e.g., \"hubspot\")"
    }
  },
  "required": [
    "externalId",
    "externalSource"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "firstName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "example": "John",
          "description": "First name of the contact"
        },
        "lastName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100,
          "example": "Doe",
          "description": "Last name of the contact"
        },
        "companyName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "Acme Corp",
          "description": "Name of the contact's company"
        },
        "companyDomain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "Company domain (e.g., \"acme.com\")"
        },
        "contactProfileUrl": {
          "type": "string",
          "maxLength": 500,
          "format": "uri",
          "example": "https://linkedin.com/in/johndoe",
          "description": "Contact profile URL of the contact (e.g., LinkedIn or other professional profile, optional)"
        },
        "linkedInSalesNavigatorUrl": {
          "type": "string",
          "maxLength": 500,
          "format": "uri",
          "example": "https://www.linkedin.com/sales/lead/ACwAAABcD...",
          "description": "LinkedIn Sales Navigator profile URL of the contact (optional)"
        },
        "jobTitle": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "VP of Sales",
          "description": "Job title of the contact (optional)"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/contact-research",
          "description": "Optional webhook URL to receive notifications when processing completes"
        }
      },
      "required": [
        "firstName",
        "lastName",
        "companyName",
        "companyDomain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the contact research request"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "allOf": [
        {
          "type": "object",
          "properties": {
            "companyLinkedInUrls": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uri"
              },
              "example": [
                "https://linkedin.com/company/google"
              ],
              "description": "LinkedIn company URLs to scope the search (note: plural — pass an array even for a single company). Supports multiple companies; results are merged and deduplicated. Omit to search across all companies.\n"
            },
            "firstName": {
              "type": "string",
              "maxLength": 100,
              "example": "John",
              "description": "First name of the contact to search for"
            },
            "lastName": {
              "type": "string",
              "maxLength": 100,
              "example": "Doe",
              "description": "Last name of the contact to search for"
            },
            "jobTitles": {
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 200
              },
              "example": [
                "Engineering Manager",
                "VP Engineering"
              ],
              "description": "Job titles to search for (plural — pass an array)"
            },
            "keywords": {
              "type": "string",
              "maxLength": 500,
              "example": "Kubernetes, DevOps",
              "description": "Keywords to search for in contact profiles (e.g., skills, technologies)"
            },
            "countries": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 2,
                "maxLength": 2,
                "pattern": "^[A-Za-z]{2}$"
              },
              "example": [
                "US",
                "GB",
                "DE"
              ],
              "description": "Countries to filter contacts by location. Must be ISO 3166-1 alpha-2 codes (e.g., \"US\", \"GB\", \"DE\") — full country names are not accepted."
            },
            "departments": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Accounting",
                  "Administrative",
                  "Arts and Design",
                  "Business Development",
                  "Community and Social Services",
                  "Consulting",
                  "Customer Success and Support",
                  "Education",
                  "Engineering",
                  "Entrepreneurship",
                  "Finance",
                  "Healthcare Services",
                  "Human Resources",
                  "Information Technology",
                  "Legal",
                  "Marketing",
                  "Media and Communication",
                  "Military and Protective Services",
                  "Operations",
                  "Product Management",
                  "Program and Project Management",
                  "Purchasing",
                  "Quality Assurance",
                  "Real Estate",
                  "Research",
                  "Sales"
                ]
              },
              "example": [
                "Sales",
                "Marketing"
              ],
              "description": "Department (function) filter using LinkedIn Sales Navigator taxonomy. Multiple values are OR'd together. Combined with other filters via AND. All values are treated as INCLUDED — exclusion is not currently supported.\n"
            },
            "seniorityLevels": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Owner / Partner",
                  "CXO",
                  "Vice President",
                  "Director",
                  "Experienced Manager",
                  "Entry Level Manager",
                  "Strategic",
                  "Senior",
                  "Entry Level",
                  "In Training"
                ]
              },
              "example": [
                "CXO",
                "Vice President",
                "Director"
              ],
              "description": "Seniority level filter using LinkedIn Sales Navigator taxonomy. Multiple values are OR'd together. Combined with other filters via AND. All values are treated as INCLUDED — exclusion is not currently supported.\n"
            },
            "limit": {
              "default": 25,
              "example": 25,
              "description": "Maximum number of contacts to return per page",
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "offset": {
              "default": 0,
              "example": 0,
              "description": "Zero-based offset for pagination",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "additionalProperties": false
        },
        {
          "anyOf": [
            {},
            {},
            {},
            {},
            {},
            {},
            {},
            {}
          ]
        }
      ],
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum number of lists to return (1–100, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of lists to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200,
          "example": "Engineering leads at Stripe",
          "description": "Display name for the contact list"
        },
        "filters": {
          "type": "object",
          "properties": {
            "companyLinkedInUrls": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "uri"
              },
              "example": [
                "https://www.linkedin.com/company/stripe"
              ],
              "description": "LinkedIn company URLs to scope the search. Supports multiple companies. Omit to search across all companies."
            },
            "jobTitles": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "Engineering Manager",
                "VP Engineering"
              ],
              "description": "Job titles to filter contacts by"
            },
            "keywords": {
              "type": "string",
              "example": "Kubernetes",
              "description": "Keywords to search for in contact profiles"
            },
            "countries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "US",
                "GB"
              ],
              "description": "Countries to filter by (ISO 3166-1 alpha-2 codes)"
            }
          },
          "additionalProperties": {},
          "description": "Search filters stored on a contact list"
        }
      },
      "required": [
        "name",
        "filters"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the contact list"
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the contact list"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200,
          "example": "Senior engineers at Stripe",
          "description": "New display name for the contact list"
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "listId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the contact list"
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the contact list"
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of contacts to return (1–100, default 25)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of contacts to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum number of templates to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of templates to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "includeDeleted": {
      "default": false,
      "description": "Include deleted templates in the response",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "CRM Detection",
          "description": "User-friendly name for the template"
        },
        "description": {
          "type": "string",
          "maxLength": 1000,
          "example": "Identifies which CRM system a company is using",
          "description": "Optional description of what this template does"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "example": "Which CRM are they using?",
          "description": "The research question to ask about companies"
        },
        "answerType": {
          "default": "open_text",
          "example": "open_text",
          "description": "The expected format of the answer",
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contacts_generation",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ]
        },
        "outputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "JSON Schema defining the expected output structure. Required when answerType is \"json_schema\".\nSee CreateSignalRequest.outputSchema for full documentation.\n"
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "example": "important",
          "description": "The importance/weight of the signal"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "example": {
            "ranges": [
              {
                "rangeStart": 0,
                "rangeEnd": 20,
                "answerQualification": "poor"
              },
              {
                "rangeStart": 20,
                "rangeEnd": 50,
                "answerQualification": "neutral"
              },
              {
                "rangeStart": 50,
                "rangeEnd": 100,
                "answerQualification": "excellent"
              }
            ]
          },
          "description": "Qualification criteria mapping answer values based on answerType.\nStructure varies by answerType:\n- For percentage/number/currency: { ranges: [{ rangeStart, rangeEnd, answerQualification }] }\n- For boolean: { yes: \"qualification\", no: \"qualification\" }\n- For list: { choices: { key: { answerQualification, label } } }\n\nValid answerQualification values: disqualified, poor, neutral, good, excellent\n"
        }
      },
      "required": [
        "name",
        "question"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "templateId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the template"
    }
  },
  "required": [
    "templateId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "templateId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the template to update"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "CRM Detection",
          "description": "User-friendly name for the template"
        },
        "description": {
          "type": "string",
          "maxLength": 1000,
          "example": "Identifies which CRM system a company is using",
          "description": "Optional description of what this template does"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "example": "Which CRM are they using?",
          "description": "The research question to ask about companies"
        },
        "answerType": {
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ],
          "example": "open_text",
          "description": "The expected format of the answer"
        },
        "outputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "JSON Schema defining the expected output structure. Required when answerType is \"json_schema\".\n"
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "example": "important",
          "description": "The importance/weight of the signal"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Qualification criteria mapping answer values based on answerType"
        }
      },
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "templateId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "templateId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the template to delete"
    }
  },
  "required": [
    "templateId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum number of subscriptions to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of subscriptions to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "signalTemplateId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
          "example": "e45c1dc4-d422-4b51-956b-cb6d3ddaf250",
          "description": "ID of an existing signal template. If omitted, `name` and `question`\nare required to create a template inline.\n"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "CRM Detection",
          "description": "Template name (required when creating inline, ignored when signalTemplateId is provided)"
        },
        "description": {
          "type": "string",
          "maxLength": 1000,
          "description": "Template description (optional, for inline creation)"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "example": "Which CRM are they using?",
          "description": "Research question (required when creating inline)"
        },
        "answerType": {
          "default": "open_text",
          "description": "Expected answer format (for inline creation, defaults to open_text)",
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ]
        },
        "outputSchema": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "JSON Schema for custom output (when answerType is json_schema)"
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "description": "Importance of the signal (for inline creation)"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Qualification criteria for scoring answers (for inline creation)"
        },
        "frequency": {
          "type": "string",
          "enum": [
            "daily",
            "weekly",
            "monthly"
          ],
          "example": "weekly",
          "description": "Preset schedule frequency. Mutually exclusive with `cronExpression` —\nexactly one must be provided.\n"
        },
        "cronExpression": {
          "type": "string",
          "example": "0 9 * * 1,3,5",
          "description": "Custom cron expression (5-field). Mutually exclusive with `frequency` —\nexactly one must be provided.\n"
        },
        "timezone": {
          "type": "string",
          "example": "America/New_York",
          "description": "IANA timezone for scheduling (defaults to UTC)"
        },
        "listId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
          "description": "Contact list ID to scope signal execution"
        }
      },
      "required": [
        "listId"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to update"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "frequency": {
          "type": "string",
          "enum": [
            "daily",
            "weekly",
            "monthly"
          ],
          "example": "weekly",
          "description": "Preset schedule frequency. Mutually exclusive with `cronExpression`.\n"
        },
        "cronExpression": {
          "type": "string",
          "example": "0 9 * * 1,3,5",
          "description": "Custom cron expression (5-field). Mutually exclusive with `frequency`.\n"
        },
        "timezone": {
          "type": "string",
          "example": "America/New_York",
          "description": "IANA timezone for scheduling"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "description": "The subscription display name"
        },
        "question": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "description": "The research question"
        },
        "answerType": {
          "type": "string",
          "enum": [
            "open_text",
            "number",
            "boolean",
            "list",
            "percentage",
            "currency",
            "url",
            "contacts",
            "contact_posts",
            "contact_engagements",
            "json_schema"
          ],
          "description": "Expected answer format"
        },
        "description": {
          "type": "string",
          "maxLength": 1000,
          "description": "Signal description"
        },
        "outputSchema": {
          "anyOf": [
            {
              "type": "object",
              "properties": {},
              "additionalProperties": {}
            },
            {
              "type": "null"
            }
          ],
          "description": "JSON schema for json_schema answer type. Send null to clear."
        },
        "weight": {
          "type": "string",
          "enum": [
            "important",
            "nice_to_have",
            "not_important"
          ],
          "description": "Signal importance weight"
        },
        "qualificationCriteria": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Qualification criteria"
        }
      },
      "required": [
        "timezone",
        "name",
        "question",
        "answerType"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "subscriptionId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to start"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to stop"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to trigger"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription whose actions to list"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of actions to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of actions to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription to add the action to"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "const": "webhook",
          "example": "webhook",
          "description": "The action type discriminator"
        },
        "webhook": {
          "type": "object",
          "properties": {
            "destination": {
              "type": "string",
              "format": "uri",
              "example": "https://example.com/webhook",
              "description": "The URL to deliver webhook payloads to"
            }
          },
          "required": [
            "destination"
          ],
          "additionalProperties": {},
          "description": "Configuration for a webhook action."
        }
      },
      "required": [
        "type"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "subscriptionId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription that owns the action"
    },
    "actionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The action ID"
    }
  },
  "required": [
    "subscriptionId",
    "actionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription that owns the action"
    },
    "actionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The action ID to update"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "webhook": {
          "type": "object",
          "properties": {
            "destination": {
              "type": "string",
              "format": "uri",
              "example": "https://example.com/webhook",
              "description": "The URL to deliver webhook payloads to"
            }
          },
          "required": [
            "destination"
          ],
          "additionalProperties": {},
          "description": "Configuration for a webhook action."
        }
      },
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "subscriptionId",
    "actionId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription that owns the action"
    },
    "actionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The action ID to delete"
    }
  },
  "required": [
    "subscriptionId",
    "actionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription that owns the action"
    },
    "actionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The action ID to pause"
    }
  },
  "required": [
    "subscriptionId",
    "actionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The subscription that owns the action"
    },
    "actionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The action ID to unpause"
    }
  },
  "required": [
    "subscriptionId",
    "actionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
      "description": "Filter summaries by company domain (e.g., \"acme.com\")"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of results per page",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of results to skip for pagination",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string",
          "minLength": 1,
          "maxLength": 253,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "example": "acme.com",
          "description": "The company domain to generate a summary for (e.g., \"acme.com\")"
        }
      },
      "required": [
        "domain"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum number of subscriptions to return (1-100, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of subscriptions to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "includeDeleted": {
      "default": false,
      "description": "Include soft-deleted subscriptions in the response",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "JOB_POSTS",
            "LINKEDIN_POST",
            "FUND_RAISED",
            "RECENT_INVESTMENT",
            "IPO",
            "IPO_LIFECYCLE"
          ],
          "example": "JOB_POSTS",
          "description": "The type of market signal to monitor. Determines which data sources are polled\nand which filter schema is accepted.\n"
        },
        "name": {
          "type": "string",
          "maxLength": 200,
          "example": "DevOps hiring tracker",
          "description": "Optional display name for the subscription"
        },
        "prompt": {
          "type": "string",
          "example": "Find companies hiring machine learning engineers at seed to Series B startups in Europe",
          "description": "Natural language prompt for AI-based filter generation (JOB_POSTS only).\nWhen provided without filters, the AI generates complete filters from the prompt.\nWhen provided with filters, the AI augments the filters with prompt intent.\nNot yet supported for LINKEDIN_POST.\n"
        },
        "filters": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Subscription filters. The schema depends on the `type` field:\n\n**JOB_POSTS filters:**\n- `titleKeywords` (string[]): Natural language title matching\n- `excludeTitleKeywords` (string[]): Title exclusions\n- `titlePatterns` (string[]): Regex patterns for job titles\n- `excludeTitlePatterns` (string[]): Regex exclusion patterns for titles\n- `descriptionKeywords` (string[]): Description keyword matching\n- `excludeDescriptionKeywords` (string[]): Description exclusions\n- `descriptionPatterns` (string[]): Regex patterns for descriptions\n- `excludeDescriptionPatterns` (string[]): Regex exclusion patterns for descriptions\n- `countries` (string[]): ISO country codes for job location\n- `seniority` (string[]): Seniority levels (c_level, staff, senior, mid_level, junior)\n- `technologySlugs` (string[]): Required technologies\n- `minSalaryUsd` (number): Minimum annual salary in USD\n- `maxSalaryUsd` (number): Maximum annual salary in USD\n- `remote` (boolean): Filter for remote jobs only\n- `companyDomains` (string[]): Specific company domains to monitor\n- `excludeCompanyDomains` (string[]): Company domains to exclude\n- `companyNames` (string[]): Partial match company names\n- `excludeCompanyNames` (string[]): Company names to exclude\n- `minEmployees` (number): Minimum company size\n- `maxEmployees` (number): Maximum company size\n- `companyCountries` (string[]): Company HQ country codes\n- `companyTechnologySlugs` (string[]): Company tech stack filter\n- `excludeRecruitingAgencies` (boolean): Filter out staffing agencies\n- `fundingStages` (string[]): Funding stages (seed, series_a, series_b, etc.)\n- `industryIds` (string[]): LinkedIn industry IDs to include\n- `excludeIndustryIds` (string[]): LinkedIn industry IDs to exclude\n- `promptFilter` (string): AI-based relevance scoring prompt\n- `maxLookbackDays` (number): How far back to look in days\n\n**LINKEDIN_POST filters:**\n- `keywordsAll` (string[]): Boolean AND keywords\n- `keywordsAny` (string[]): Boolean OR keywords\n- `keywordsNone` (string[]): Boolean NOT keywords\n- `promptFilter` (string): AI-based content + persona filtering prompt\n- `maxLookbackDays` (number): Lookback period in days\n\n**FUND_RAISED / RECENT_INVESTMENT / IPO filters (shared):**\n- `searchQueries` (string[]): Custom search queries\n- `keywords` (string[]): Keywords appended to default queries\n- `excludeKeywords` (string[]): Excluded keywords\n- `countries` (string[]): Geographic filtering (reserved)\n- `minAmountUsd` (number): Minimum deal size (reserved)\n- `maxLookbackDays` (number): Lookback period in days\n- `promptFilter` (string): AI-based relevance scoring prompt (reserved)\n- `sources` (string[]): Restrict discovery to specific data sources — `\"web\"` (news + RSS) and/or `\"edgar\"` (SEC filings). Omit for all sources. Honoured by the NestJS engine only.\n\n**IPO_LIFECYCLE filters:**\n- `eventTypes` (string[], required): Lifecycle stages to deliver — `filing`, `amendment`, `pricing`, `prospectus`, `form5500`\n- `formTypes` (string[]): Registration families to include — `S-1`, `F-1`, `S-11`, `N-2` (applies to filing/amendment events; matched with the `/A` amendment suffix stripped)\n- `listingTypes` (string[]): `traditional`, `spac`, `direct_listing`\n- `countries` (string[]): Only `[\"US\"]` is accepted in v1; other values are rejected with 422\n- `maxLookbackDays` (number): Delivery lookback window in days\n\nRequired for LINKEDIN_POST and IPO_LIFECYCLE. Optional for JOB_POSTS when `prompt` is provided.\n"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "example": "https://myapp.com/webhooks/market-signals",
          "description": "URL to receive webhook notifications when new signals are matched"
        },
        "webhookSecret": {
          "type": "string",
          "example": "whsec_abc123",
          "description": "Optional secret for HMAC-SHA256 webhook signature verification"
        },
        "intervalSignalLimit": {
          "default": 500,
          "example": 100,
          "description": "Maximum number of signals to deliver per polling interval (1-10000, default 500)",
          "type": "integer",
          "minimum": 1,
          "maximum": 10000
        },
        "interval": {
          "default": "daily",
          "example": "daily",
          "description": "Polling interval for checking new signals",
          "type": "string",
          "enum": [
            "daily",
            "weekly"
          ]
        }
      },
      "required": [
        "type",
        "webhookUrl"
      ],
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to update"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200,
          "example": "Updated DevOps tracker",
          "description": "Updated display name"
        },
        "prompt": {
          "type": "string",
          "description": "Updated natural language prompt (JOB_POSTS only)"
        },
        "filters": {
          "type": "object",
          "properties": {},
          "additionalProperties": {},
          "description": "Updated subscription filters (must match the subscription's type schema)"
        },
        "webhookUrl": {
          "type": "string",
          "maxLength": 2048,
          "format": "uri",
          "description": "Updated webhook URL"
        },
        "webhookSecret": {
          "type": "string",
          "description": "Updated webhook secret"
        },
        "intervalSignalLimit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10000,
          "description": "Updated maximum signals per interval (1-10000)"
        },
        "interval": {
          "type": "string",
          "enum": [
            "daily",
            "weekly"
          ],
          "description": "Updated polling interval. Changing this restarts the polling schedule."
        }
      },
      "additionalProperties": false,
      "description": "Request body"
    }
  },
  "required": [
    "subscriptionId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to delete"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to pause"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to resume"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription to trigger"
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "subscriptionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the subscription"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of signals to return (1-100, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of signals to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "subscriptionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Acme Corp",
          "description": "New display name for the organisation"
        },
        "website": {
          "type": "string",
          "example": "acme.com",
          "description": "New website domain for the organisation"
        },
        "description": {
          "type": "object",
          "properties": {
            "general": {
              "type": "string",
              "example": "Acme Corp builds enterprise software for logistics teams.",
              "description": "General overview of the organisation"
            },
            "products": {
              "type": "string",
              "example": "Route optimisation platform and real-time freight tracking.",
              "description": "Description of the organisation's products or services"
            },
            "useCases": {
              "type": "string",
              "example": "Reducing delivery costs for 3PL operators and e-commerce brands.",
              "description": "Key use cases the organisation addresses"
            },
            "valueProp": {
              "type": "string",
              "example": "Cut logistics costs by 20% with AI-powered route optimisation.",
              "description": "The organisation's core value proposition"
            }
          },
          "additionalProperties": {},
          "description": "Descriptive text fields for the organisation"
        }
      },
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "HubSpot — Technology companies",
          "description": "A human-readable name for the imported list (1–200 characters)"
        },
        "source": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "hubspot",
              "example": "hubspot",
              "description": "Import source type. Currently only `hubspot` is supported."
            },
            "filter": {
              "type": "object",
              "properties": {
                "propertyName": {
                  "type": "string",
                  "example": "industry",
                  "description": "The HubSpot company property to filter on (e.g. `industry`, `city`, `hs_lead_status`)"
                },
                "operator": {
                  "type": "string",
                  "enum": [
                    "EQ",
                    "NEQ",
                    "GT",
                    "GTE",
                    "LT",
                    "LTE",
                    "HAS_PROPERTY",
                    "NOT_HAS_PROPERTY",
                    "CONTAINS_TOKEN",
                    "NOT_CONTAINS_TOKEN"
                  ],
                  "example": "EQ",
                  "description": "Comparison operator. Value-free operators (`HAS_PROPERTY`, `NOT_HAS_PROPERTY`)\ndo not require a `value` field. All others do.\n"
                },
                "value": {
                  "type": "string",
                  "example": "Technology",
                  "description": "The value to compare against. Required for all operators except `HAS_PROPERTY` and `NOT_HAS_PROPERTY`."
                }
              },
              "required": [
                "propertyName",
                "operator"
              ],
              "additionalProperties": {},
              "description": "A single HubSpot property filter used to select companies for import"
            }
          },
          "required": [
            "type",
            "filter"
          ],
          "additionalProperties": {},
          "description": "Describes the external source to import companies from"
        }
      },
      "required": [
        "name",
        "source"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "filter": {
          "type": "object",
          "properties": {
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company domains"
            },
            "names": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company names"
            },
            "handles": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company handles"
            },
            "websites": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company websites"
            },
            "industries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "Computer Software",
                "Internet"
              ],
              "description": "Filter by industry names"
            },
            "sizes": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "51-200",
                "201-500"
              ],
              "description": "Filter by company size ranges"
            },
            "types": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company types"
            },
            "founded": {
              "type": "object",
              "properties": {
                "before": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded before this year"
                },
                "after": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded after this year"
                }
              },
              "additionalProperties": {},
              "description": "Filter by founded year range"
            },
            "location": {
              "type": "object",
              "properties": {
                "cities": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by city names"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by state/province names"
                },
                "countryCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "US",
                    "GB"
                  ],
                  "description": "Filter by ISO country codes"
                }
              },
              "additionalProperties": {},
              "description": "Filter by geographic location"
            },
            "exclude": {
              "type": "object",
              "properties": {
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "types": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "domains": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "location": {
                  "type": "object",
                  "properties": {
                    "cities": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "states": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "countryCodes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {},
              "description": "Exclusion filters (companies matching these are removed)"
            },
            "questionIds": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by signal question IDs"
            },
            "technologies": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "stripe",
                "hubspot"
              ],
              "description": "Filter by technology slugs (companies must use at least one of the specified technologies)"
            }
          },
          "additionalProperties": {},
          "description": "Criteria for filtering companies"
        }
      },
      "required": [
        "filter"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum number of lists to return (1–100, default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of lists to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "Mid-size US SaaS companies",
          "description": "A human-readable name for the list (1–200 characters)"
        },
        "filter": {
          "type": "object",
          "properties": {
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company domains"
            },
            "names": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company names"
            },
            "handles": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company handles"
            },
            "websites": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company websites"
            },
            "industries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "Computer Software",
                "Internet"
              ],
              "description": "Filter by industry names"
            },
            "sizes": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "51-200",
                "201-500"
              ],
              "description": "Filter by company size ranges"
            },
            "types": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company types"
            },
            "founded": {
              "type": "object",
              "properties": {
                "before": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded before this year"
                },
                "after": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded after this year"
                }
              },
              "additionalProperties": {},
              "description": "Filter by founded year range"
            },
            "location": {
              "type": "object",
              "properties": {
                "cities": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by city names"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by state/province names"
                },
                "countryCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "US",
                    "GB"
                  ],
                  "description": "Filter by ISO country codes"
                }
              },
              "additionalProperties": {},
              "description": "Filter by geographic location"
            },
            "exclude": {
              "type": "object",
              "properties": {
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "types": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "domains": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "location": {
                  "type": "object",
                  "properties": {
                    "cities": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "states": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "countryCodes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {},
              "description": "Exclusion filters (companies matching these are removed)"
            },
            "questionIds": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by signal question IDs"
            },
            "technologies": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "stripe",
                "hubspot"
              ],
              "description": "Filter by technology slugs (companies must use at least one of the specified technologies)"
            }
          },
          "additionalProperties": {},
          "description": "Criteria for filtering companies"
        }
      },
      "required": [
        "name",
        "filter"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the company list"
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the company list to update"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200,
          "example": "Updated list name",
          "description": "Updated name for the list (1–200 characters)"
        },
        "filter": {
          "type": "object",
          "properties": {
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company domains"
            },
            "names": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company names"
            },
            "handles": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company handles"
            },
            "websites": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company websites"
            },
            "industries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "Computer Software",
                "Internet"
              ],
              "description": "Filter by industry names"
            },
            "sizes": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "51-200",
                "201-500"
              ],
              "description": "Filter by company size ranges"
            },
            "types": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company types"
            },
            "founded": {
              "type": "object",
              "properties": {
                "before": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded before this year"
                },
                "after": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded after this year"
                }
              },
              "additionalProperties": {},
              "description": "Filter by founded year range"
            },
            "location": {
              "type": "object",
              "properties": {
                "cities": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by city names"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by state/province names"
                },
                "countryCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "US",
                    "GB"
                  ],
                  "description": "Filter by ISO country codes"
                }
              },
              "additionalProperties": {},
              "description": "Filter by geographic location"
            },
            "exclude": {
              "type": "object",
              "properties": {
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "types": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "domains": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "location": {
                  "type": "object",
                  "properties": {
                    "cities": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "states": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "countryCodes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {},
              "description": "Exclusion filters (companies matching these are removed)"
            },
            "questionIds": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by signal question IDs"
            },
            "technologies": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "stripe",
                "hubspot"
              ],
              "description": "Filter by technology slugs (companies must use at least one of the specified technologies)"
            }
          },
          "additionalProperties": {},
          "description": "Criteria for filtering companies"
        }
      },
      "required": [
        "name",
        "filter"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "listId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the company list to delete"
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "description": "The unique identifier of the company list"
    },
    "limit": {
      "default": 25,
      "description": "Maximum number of companies to return (1–100, default 25)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of companies to skip for pagination (default 0)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The unique identifier of the company list"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "fields": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "industry",
              "size",
              "founded",
              "city",
              "state",
              "country_code"
            ]
          },
          "example": [
            "industry",
            "size",
            "country_code"
          ],
          "description": "Optional firmographic columns to include after the fixed `name` and\n`website` columns, in the order specified. Unknown values return 422.\n"
        },
        "signalTemplateIds": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "example": [
            "123e4567-e89b-12d3-a456-426614174000"
          ],
          "description": "IDs of signal templates whose subscriptions should be included as\ncolumns. Two columns are added per subscription:\n`{signal_name}_answer` and `{signal_name}_confidence`. If absent\nor empty, no signal columns are added.\n"
        }
      },
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "listId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "filter": {
          "type": "object",
          "properties": {
            "domains": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company domains"
            },
            "names": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company names"
            },
            "handles": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company handles"
            },
            "websites": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company websites"
            },
            "industries": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "Computer Software",
                "Internet"
              ],
              "description": "Filter by industry names"
            },
            "sizes": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "51-200",
                "201-500"
              ],
              "description": "Filter by company size ranges"
            },
            "types": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by company types"
            },
            "founded": {
              "type": "object",
              "properties": {
                "before": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded before this year"
                },
                "after": {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991,
                  "description": "Founded after this year"
                }
              },
              "additionalProperties": {},
              "description": "Filter by founded year range"
            },
            "location": {
              "type": "object",
              "properties": {
                "cities": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by city names"
                },
                "states": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Filter by state/province names"
                },
                "countryCodes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "example": [
                    "US",
                    "GB"
                  ],
                  "description": "Filter by ISO country codes"
                }
              },
              "additionalProperties": {},
              "description": "Filter by geographic location"
            },
            "exclude": {
              "type": "object",
              "properties": {
                "industries": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "sizes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "types": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "domains": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "location": {
                  "type": "object",
                  "properties": {
                    "cities": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "states": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "countryCodes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": {}
                }
              },
              "additionalProperties": {},
              "description": "Exclusion filters (companies matching these are removed)"
            },
            "questionIds": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Filter by signal question IDs"
            },
            "technologies": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "example": [
                "stripe",
                "hubspot"
              ],
              "description": "Filter by technology slugs (companies must use at least one of the specified technologies)"
            }
          },
          "additionalProperties": {},
          "description": "Criteria for filtering companies"
        }
      },
      "required": [
        "filter"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "profileType": {
          "type": "string",
          "enum": [
            "company",
            "contact"
          ],
          "description": "Object type this profile will score"
        },
        "name": {
          "type": "string",
          "example": "EMEA Enterprise"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "profileType",
        "name"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    }
  },
  "required": [
    "profileId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "example": "Enterprise ICP"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "example": "Companies with 1000+ headcount"
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "profileId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    }
  },
  "required": [
    "profileId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    }
  },
  "required": [
    "profileId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    },
    "__requestBody": {
      "type": "object",
      "properties": {
        "signalTemplateId": {
          "type": "string"
        },
        "dimension": {
          "type": "string",
          "enum": [
            "fit",
            "urgency"
          ]
        },
        "answerType": {
          "type": "string",
          "enum": [
            "boolean",
            "number",
            "percentage",
            "currency",
            "list"
          ],
          "description": "Drives shape validation for `pointValues`. Must match the referenced\nsignal template's answer type — mismatch surfaces as an\n`INVALID_POINT_VALUES` 422 at write time rather than a silent\ncompute failure later.\n"
        },
        "pointValues": {
          "type": "object",
          "properties": {
            "true": {
              "type": "number",
              "example": 20,
              "description": "Points awarded when a boolean signal answers `true`. Used by `boolean` answer types."
            },
            "false": {
              "type": "number",
              "example": -5,
              "description": "Points awarded when a boolean signal answers `false`. Used by `boolean` answer types."
            },
            "ranges": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "min": {
                    "type": "number"
                  },
                  "max": {
                    "type": "number"
                  },
                  "points": {
                    "type": "number"
                  }
                },
                "required": [
                  "min",
                  "max",
                  "points"
                ],
                "additionalProperties": {}
              },
              "description": "Used by `number`, `percentage`, and `currency` answer types. Upper bound is exclusive."
            },
            "choices": {
              "type": "object",
              "properties": {},
              "additionalProperties": {
                "type": "number"
              },
              "example": {
                "Salesforce": 10,
                "HubSpot": 8,
                "None": -10
              },
              "description": "Used by `list` answer types. Map of allowed list value → points awarded if present in the answer."
            },
            "mode": {
              "type": "string",
              "enum": [
                "additive",
                "best-match",
                "contains-all",
                "contains-none",
                "exact-match"
              ],
              "example": "additive",
              "description": "Optional. Controls how a `list` rule combines matched choices. Defaults\nto `additive` (sum matched, clamp to highest single choice) — the v1\nbehaviour. Other modes:\n\n* `best-match` — award only the highest-scoring matched choice.\n* `contains-all` — award `max(choices)` only if every configured choice appears.\n* `contains-none` — award `max(choices)` only if none of the configured choices appear.\n* `exact-match` — award `sum(choices)` only when the answer set equals the configured set exactly.\n"
            }
          },
          "additionalProperties": {},
          "example": {
            "ranges": [
              {
                "min": 0,
                "max": 100,
                "points": 2
              },
              {
                "min": 100,
                "max": 1000,
                "points": 10
              },
              {
                "min": 1000,
                "max": 100000,
                "points": 25
              }
            ]
          },
          "description": "Point-value mapping for one rule. The shape varies by the answer type of the\nreferenced signal template — exactly one of `true`/`false`, `ranges`, or `choices`\nis populated.\n"
        }
      },
      "required": [
        "signalTemplateId",
        "dimension",
        "answerType",
        "pointValues"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "profileId",
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "profileId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring profile UUID"
    },
    "ruleId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Scoring rule UUID"
    }
  },
  "required": [
    "profileId",
    "ruleId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "objectType": {
      "type": "string",
      "enum": [
        "company",
        "contact"
      ],
      "description": "Object type (`company` or `contact`)"
    },
    "objectId": {
      "type": "string",
      "description": "For `company` use the domain (e.g. `acme.com`); for `contact` use the LinkedIn profile URL"
    }
  },
  "required": [
    "objectType",
    "objectId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "profileId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "objectType": {
          "type": "string",
          "enum": [
            "company",
            "contact"
          ]
        },
        "objectId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500,
          "description": "For `company`, the domain; for `contact`, the LinkedIn profile URL."
        }
      },
      "required": [
        "profileId",
        "objectType",
        "objectId"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "profileId": {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        "objectType": {
          "type": "string",
          "enum": [
            "company",
            "contact"
          ]
        },
        "objectIds": {
          "minItems": 1,
          "maxItems": 500,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "example": [
            "acme.com",
            "stripe.com",
            "framer.com"
          ],
          "description": "Capped at 500 per request. Paginate larger lists by issuing\nmultiple requests.\n"
        }
      },
      "required": [
        "profileId",
        "objectType",
        "objectIds"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "assignmentId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Profile assignment UUID"
    }
  },
  "required": [
    "assignmentId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "objectType": {
      "type": "string",
      "enum": [
        "company",
        "contact"
      ]
    },
    "objectId": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Repeatable. For `company` use the domain; for `contact` use the LinkedIn profile URL."
    }
  },
  "required": [
    "objectType",
    "objectId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "__requestBody": {
      "type": "object",
      "properties": {
        "objectType": {
          "type": "string",
          "enum": [
            "company",
            "contact"
          ]
        },
        "objectIds": {
          "minItems": 1,
          "maxItems": 500,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "description": "For `company`, domains; for `contact`, LinkedIn profile URLs.\nCapped at 500 per request — paginate larger lists.\n"
        }
      },
      "required": [
        "objectType",
        "objectIds"
      ],
      "additionalProperties": {},
      "description": "Request body"
    }
  },
  "required": [
    "__requestBody"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}