{
  "components": {
    "schemas": {
      "Account": {
        "additionalProperties": false,
        "properties": {
          "crm_id": {
            "anyOf": [
              {
                "pattern": "^[0-9]{1,30}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Crm Id"
          },
          "id": {
            "pattern": "^[A-Za-z0-9_.:-]{1,160}$",
            "title": "Id",
            "type": "string"
          },
          "name": {
            "maxLength": 200,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "Account",
        "type": "object"
      },
      "Activation": {
        "additionalProperties": false,
        "properties": {
          "expected_signal_version": {
            "minimum": 1.0,
            "title": "Expected Signal Version",
            "type": "integer"
          },
          "preview_job_id": {
            "format": "uuid",
            "title": "Preview Job Id",
            "type": "string"
          }
        },
        "required": [
          "expected_signal_version",
          "preview_job_id"
        ],
        "title": "Activation",
        "type": "object"
      },
      "Backtest": {
        "additionalProperties": false,
        "properties": {
          "cutoff": {
            "format": "date-time",
            "title": "Cutoff",
            "type": "string"
          },
          "version": {
            "anyOf": [
              {
                "minimum": 1.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          }
        },
        "required": [
          "cutoff"
        ],
        "title": "Backtest",
        "type": "object"
      },
      "Batch": {
        "additionalProperties": false,
        "properties": {
          "events": {
            "items": {
              "$ref": "#/components/schemas/Event"
            },
            "maxItems": 1000,
            "minItems": 1,
            "title": "Events",
            "type": "array"
          }
        },
        "required": [
          "events"
        ],
        "title": "Batch",
        "type": "object"
      },
      "Binding": {
        "additionalProperties": false,
        "properties": {
          "account_id": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Account Id",
            "type": "string"
          },
          "connection_id": {
            "maxLength": 100,
            "minLength": 1,
            "title": "Connection Id",
            "type": "string"
          },
          "external_id": {
            "maxLength": 200,
            "minLength": 1,
            "title": "External Id",
            "type": "string"
          },
          "object_type": {
            "pattern": "^[a-z][a-z0-9_]{0,39}$",
            "title": "Object Type",
            "type": "string"
          }
        },
        "required": [
          "connection_id",
          "object_type",
          "external_id",
          "account_id"
        ],
        "title": "Binding",
        "type": "object"
      },
      "CompanyNetwork": {
        "additionalProperties": false,
        "properties": {
          "account_id": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Account Id",
            "type": "string"
          },
          "network": {
            "maxLength": 50,
            "minLength": 1,
            "title": "Network",
            "type": "string"
          },
          "note": {
            "maxLength": 200,
            "minLength": 5,
            "title": "Note",
            "type": "string"
          },
          "valid_days": {
            "default": 90,
            "maximum": 365.0,
            "minimum": 1.0,
            "title": "Valid Days",
            "type": "integer"
          }
        },
        "required": [
          "network",
          "account_id",
          "note"
        ],
        "title": "CompanyNetwork",
        "type": "object"
      },
      "ConnectionPolicy": {
        "additionalProperties": false,
        "properties": {
          "analytics_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analytics Enabled"
          },
          "crm_write_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Crm Write Enabled"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          }
        },
        "title": "ConnectionPolicy",
        "type": "object"
      },
      "Contribution": {
        "additionalProperties": false,
        "properties": {
          "event_type": {
            "pattern": "^[a-z][a-z0-9_]{0,63}$",
            "title": "Event Type",
            "type": "string"
          },
          "max_count": {
            "default": 1,
            "maximum": 100.0,
            "minimum": 1.0,
            "title": "Max Count",
            "type": "integer"
          },
          "points": {
            "maximum": 10000.0,
            "minimum": 1.0,
            "title": "Points",
            "type": "integer"
          },
          "use_saved_website_points": {
            "default": false,
            "title": "Use Saved Website Points",
            "type": "boolean"
          }
        },
        "required": [
          "event_type",
          "points"
        ],
        "title": "Contribution",
        "type": "object"
      },
      "Definition": {
        "additionalProperties": false,
        "properties": {
          "contributions": {
            "items": {
              "$ref": "#/components/schemas/Contribution"
            },
            "maxItems": 20,
            "title": "Contributions",
            "type": "array"
          },
          "fit_conditions": {
            "items": {
              "$ref": "#/components/schemas/FitCondition"
            },
            "maxItems": 10,
            "title": "Fit Conditions",
            "type": "array"
          },
          "fit_points": {
            "default": 100,
            "maximum": 10000.0,
            "minimum": 1.0,
            "title": "Fit Points",
            "type": "integer"
          },
          "mode": {
            "default": "events",
            "enum": [
              "events",
              "company_fit"
            ],
            "title": "Mode",
            "type": "string"
          },
          "name": {
            "maxLength": 100,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "threshold": {
            "default": 100,
            "maximum": 1000000.0,
            "minimum": 1.0,
            "title": "Threshold",
            "type": "integer"
          },
          "website_site_id": {
            "anyOf": [
              {
                "format": "uuid",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website Site Id"
          },
          "window_days": {
            "default": 7,
            "maximum": 365.0,
            "minimum": 1.0,
            "title": "Window Days",
            "type": "integer"
          }
        },
        "required": [
          "name"
        ],
        "title": "Definition",
        "type": "object"
      },
      "Draft": {
        "additionalProperties": false,
        "properties": {
          "definition": {
            "$ref": "#/components/schemas/Definition"
          },
          "expected_version": {
            "minimum": 1.0,
            "title": "Expected Version",
            "type": "integer"
          }
        },
        "required": [
          "expected_version",
          "definition"
        ],
        "title": "Draft",
        "type": "object"
      },
      "Event": {
        "additionalProperties": false,
        "properties": {
          "deleted": {
            "default": false,
            "title": "Deleted",
            "type": "boolean"
          },
          "event_id": {
            "pattern": "^[A-Za-z0-9_.:-]{1,160}$",
            "title": "Event Id",
            "type": "string"
          },
          "event_type": {
            "pattern": "^[a-z][a-z0-9_]{0,63}$",
            "title": "Event Type",
            "type": "string"
          },
          "occurred_at": {
            "format": "date-time",
            "title": "Occurred At",
            "type": "string"
          },
          "properties": {
            "additionalProperties": true,
            "title": "Properties",
            "type": "object"
          },
          "source": {
            "default": "product",
            "pattern": "^[a-z][a-z0-9_]{0,63}$",
            "title": "Source",
            "type": "string"
          },
          "source_account_id": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Source Account Id",
            "type": "string"
          },
          "source_revision": {
            "default": 1,
            "maximum": 1000000.0,
            "minimum": 1.0,
            "title": "Source Revision",
            "type": "integer"
          }
        },
        "required": [
          "event_id",
          "source_account_id",
          "event_type",
          "occurred_at"
        ],
        "title": "Event",
        "type": "object"
      },
      "FitCondition": {
        "additionalProperties": false,
        "properties": {
          "operator": {
            "enum": [
              "present",
              "equals",
              "gte",
              "lte"
            ],
            "title": "Operator",
            "type": "string"
          },
          "property": {
            "enum": [
              "domain",
              "industry",
              "numberofemployees",
              "aantal_medewerkers"
            ],
            "title": "Property",
            "type": "string"
          },
          "value": {
            "default": "",
            "maxLength": 200,
            "title": "Value",
            "type": "string"
          }
        },
        "required": [
          "property",
          "operator"
        ],
        "title": "FitCondition",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "Mapping": {
        "additionalProperties": false,
        "properties": {
          "account_id": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Account Id",
            "type": "string"
          },
          "source": {
            "pattern": "^[a-z][a-z0-9_]{0,63}$",
            "title": "Source",
            "type": "string"
          },
          "source_account_id": {
            "maxLength": 160,
            "minLength": 1,
            "title": "Source Account Id",
            "type": "string"
          }
        },
        "required": [
          "source",
          "source_account_id",
          "account_id"
        ],
        "title": "Mapping",
        "type": "object"
      },
      "Override": {
        "additionalProperties": false,
        "properties": {
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "expected_version": {
            "minimum": 1.0,
            "title": "Expected Version",
            "type": "integer"
          },
          "explanation": {
            "default": "Customer override",
            "maxLength": 600,
            "minLength": 5,
            "pattern": "^[^\\x00]*$",
            "title": "Explanation",
            "type": "string"
          },
          "points": {
            "anyOf": [
              {
                "maximum": 100.0,
                "minimum": 0.0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Points"
          },
          "reset": {
            "default": false,
            "title": "Reset",
            "type": "boolean"
          }
        },
        "required": [
          "expected_version"
        ],
        "title": "Override",
        "type": "object"
      },
      "Publication": {
        "additionalProperties": false,
        "properties": {
          "expected_version": {
            "minimum": 1.0,
            "title": "Expected Version",
            "type": "integer"
          },
          "preview_job_id": {
            "format": "uuid",
            "title": "Preview Job Id",
            "type": "string"
          }
        },
        "required": [
          "expected_version",
          "preview_job_id"
        ],
        "title": "Publication",
        "type": "object"
      },
      "SiteCreate": {
        "additionalProperties": false,
        "properties": {
          "business_context": {
            "default": "",
            "maxLength": 1000,
            "pattern": "^[^\\x00]*$",
            "title": "Business Context",
            "type": "string"
          },
          "name": {
            "maxLength": 100,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "origins": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "title": "Origins",
            "type": "array"
          },
          "pricing_paths": {
            "items": {
              "type": "string"
            },
            "maxItems": 10,
            "title": "Pricing Paths",
            "type": "array"
          },
          "retention_days": {
            "default": 30,
            "maximum": 90.0,
            "minimum": 1.0,
            "title": "Retention Days",
            "type": "integer"
          }
        },
        "required": [
          "name",
          "origins"
        ],
        "title": "SiteCreate",
        "type": "object"
      },
      "SitePolicy": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "title": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "title": "SitePolicy",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "ctx": {
            "title": "Context",
            "type": "object"
          },
          "input": {
            "title": "Input"
          },
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      },
      "WritebackToggle": {
        "additionalProperties": false,
        "properties": {
          "enabled": {
            "title": "Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "enabled"
        ],
        "title": "WritebackToggle",
        "type": "object"
      }
    },
    "securitySchemes": {
      "TenantBearer": {
        "bearerFormat": "JWT",
        "description": "Organization-bound Auth0 API access token. Required permissions are listed per operation; this does not offer API-key or client-registration issuance.",
        "scheme": "bearer",
        "type": "http"
      },
      "TenantSession": {
        "description": "Production host-only browser session. Read csrf_token from GET /v1/me using this session; bearer authentication returns a null CSRF token and takes precedence over cookies. Session mutations require exact Origin and X-CSRF-Token. Development uses signal_session.",
        "in": "cookie",
        "name": "__Host-signal_session",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "Selected current-source customer operations under preview. Access and integrations require workspace enablement; this is not a general-availability, onboarding or external-client registration promise. Request and query models come from code; many success responses have no response model and are intentionally untyped.",
    "title": "Gather customer API — preview",
    "version": "0.1.0-preview"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/account-mappings": {
      "post": {
        "description": "Maps an authenticated producer identity to an existing canonical account. Reserved src_ identities require /v1/data/bind. Existing events need receipt replay after this mapping changes.",
        "operationId": "customer_post_v1_account_mappings",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Mapping"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Mapping",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/accounts": {
      "get": {
        "description": "Returns at most 1,000 canonical accounts. This route has no pagination parameters.",
        "operationId": "customer_get_v1_accounts",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Accounts",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      },
      "post": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_post_v1_accounts",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Account"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Put Account",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/backtests/{identifier}": {
      "post": {
        "description": "Creates a retrospective preview job with actions_allowed=false. Poll its job, then read the builder preview. Uses current mappings and latest source revisions; this is not a complete point-in-time predictive backtest.",
        "operationId": "customer_post_v1_backtests_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Backtest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Historical",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/catalog": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_builder_catalog",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Catalog",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/companies": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_builder_companies",
        "parameters": [
          {
            "in": "query",
            "name": "search",
            "required": false,
            "schema": {
              "default": "",
              "maxLength": 100,
              "title": "Search",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 50,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Companies",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/previews/{identifier}": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_builder_previews_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "include_nonmatching",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Nonmatching",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Preview",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/signal-sets/{identifier}/draft": {
      "put": {
        "description": "Saves an immutable draft using expected_version. The published version stays live. A stale version returns 409.",
        "operationId": "customer_put_v1_builder_signal_sets_identifier_draft",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Draft"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Save Draft",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/signal-sets/{identifier}/publish": {
      "post": {
        "description": "Publishes only after a completed, action-free preview of this exact saved version created within the preceding hour. expected_version and preview_job_id are checked transactionally. Existing enabled workflows can execute after publication.",
        "operationId": "customer_post_v1_builder_signal_sets_identifier_publish",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Publication"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Publish",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/signal-sets/{identifier}/versions": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_builder_signal_sets_identifier_versions",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Versions",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/builder/workflows/{identifier}/enable": {
      "post": {
        "description": "Enables an existing paused workflow after reviewing a successful preview of the applicable signal version within one hour. Uses the published version when present. Create the paused workflow in the workspace UI; workflow creation is outside this published API surface.",
        "operationId": "customer_post_v1_builder_workflows_identifier_enable",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Activation"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Enable",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:workflows"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:workflows"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/data/bind": {
      "post": {
        "description": "Reviews a governed source-object account link and queues replay of retained input. Does not infer an employer or grant missing source-purpose rights.",
        "operationId": "customer_post_v1_data_bind",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Binding"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Bind",
        "tags": [
          "Governed data"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/data/connections": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_data_connections",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Connections",
        "tags": [
          "Governed data"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/data/connections/{identifier}": {
      "patch": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_patch_v1_data_connections_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ConnectionPolicy"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Change Policy",
        "tags": [
          "Governed data"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/data/objects": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_data_objects",
        "parameters": [
          {
            "in": "query",
            "name": "connection_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 100,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Connection Id"
            }
          },
          {
            "in": "query",
            "name": "object_type",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 40,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Object Type"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Browse Objects",
        "tags": [
          "Governed data"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/data/objects/history": {
      "get": {
        "description": "Returns governed, bounded source revision projections. Current display/expiry rules apply; this is not a generic raw archive or private-body retrieval endpoint.",
        "operationId": "customer_get_v1_data_objects_history",
        "parameters": [
          {
            "in": "query",
            "name": "connection_id",
            "required": true,
            "schema": {
              "maxLength": 100,
              "title": "Connection Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "object_type",
            "required": true,
            "schema": {
              "maxLength": 40,
              "title": "Object Type",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "external_id",
            "required": true,
            "schema": {
              "maxLength": 200,
              "title": "External Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "History",
        "tags": [
          "Governed data"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/events": {
      "post": {
        "description": "Requires Idempotency-Key (1–160 characters). An acknowledged batch is archived and queued; 202 does not mean normalization or scoring has finished. Reusing a key with different content returns 409. Reserved src_ source identities are rejected.",
        "operationId": "customer_post_v1_events",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Stable receipt key; retries must preserve the exact request body.",
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 160,
              "minLength": 1,
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Batch"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Events",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "ingest:events"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "ingest:events"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/health": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_health",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Source Health",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_integrations",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "List Integrations",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations/hubspot/connect": {
      "post": {
        "description": "Requires an authenticated browser session, matching Origin and X-CSRF-Token. Read csrf_token from GET /v1/me using that session. Omit Authorization: the server prioritizes bearer authentication over cookies, so bearer authentication is rejected here even when a session cookie is also present. Returns the provider authorization URL; complete consent through the workspace browser flow. Provider application setup is a separate prerequisite.",
        "operationId": "customer_post_v1_integrations_hubspot_connect",
        "parameters": [
          {
            "description": "Required for this browser-session-only mutation. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session and omit Authorization. Bearer authentication is rejected by this route.",
            "in": "header",
            "name": "Origin",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for this browser-session-only mutation. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session and omit Authorization. Bearer authentication is rejected by this route.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantSession": []
          }
        ],
        "summary": "Begin Connection",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-browser-session-required": true,
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations/hubspot/sync": {
      "post": {
        "description": "Queues a company synchronization job for an already configured, connected HubSpot portal. Provider credentials, grants and current connection state remain authoritative.",
        "operationId": "customer_post_v1_integrations_hubspot_sync",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Start Sync",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations/hubspot/writeback/enable": {
      "post": {
        "description": "Enabling checks actual company-write scope and the four existing compatible remote property schemas. This endpoint validates property schemas; it does not create them. Disabling stops future writes and retains current remote values.",
        "operationId": "customer_post_v1_integrations_hubspot_writeback_enable",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WritebackToggle"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Enable Writeback",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations/hubspot/writeback/request": {
      "post": {
        "description": "Changes requested company-write access and disables runtime writeback until separately enabled. It does not itself grant OAuth consent or create CRM properties.",
        "operationId": "customer_post_v1_integrations_hubspot_writeback_request",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WritebackToggle"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Request Writeback",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/integrations/hubspot/writeback/retry": {
      "post": {
        "description": "Requires enabled writeback and queues retry/reconciliation of pending desired outputs. Uses current desired revisions and remote readback rather than blindly resending older writes.",
        "operationId": "customer_post_v1_integrations_hubspot_writeback_retry",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Retry Writeback",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/jobs": {
      "get": {
        "description": "Returns at most 50 recent jobs. An accepted job can remain queued, fail, retry or become dead.",
        "operationId": "customer_get_v1_jobs",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Jobs",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/jobs/{identifier}": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_jobs_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Job",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/me": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_me",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Me",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/observations": {
      "get": {
        "description": "Returns the governed raw observation feed with source/type/account/time filters and cursor pagination. Follow a non-null next_cursor even when a page is short. Corrections or revoked policy may change visibility between pages.",
        "operationId": "customer_get_v1_observations",
        "parameters": [
          {
            "in": "query",
            "name": "source",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Source"
            }
          },
          {
            "in": "query",
            "name": "event_type",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Event Type"
            }
          },
          {
            "in": "query",
            "name": "account_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 160,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Account Id"
            }
          },
          {
            "in": "query",
            "name": "identity",
            "required": false,
            "schema": {
              "default": "all",
              "pattern": "^(all|resolved|unresolved)$",
              "title": "Identity",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "occurred_after",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Occurred After"
            }
          },
          {
            "in": "query",
            "name": "occurred_before",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 64,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Occurred Before"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 2048,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "in": "query",
            "name": "page_size",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "title": "Page Size",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Observations",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/observations/catalog": {
      "get": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_get_v1_observations_catalog",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Catalog",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/receipts/{identifier}/replay": {
      "post": {
        "description": "Queues normalization of retained input using current account mappings. Logical event identity prevents replay from inflating scores. This is not physical deletion or historical point-in-time reconstruction.",
        "operationId": "customer_post_v1_receipts_identifier_replay",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Replay",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/signal-sets": {
      "get": {
        "description": "Returns at most 100 signal sets, including latest drafts and current published definitions.",
        "operationId": "customer_get_v1_signal_sets",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Definitions",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      },
      "post": {
        "description": "Requires the listed current workspace permission. Source policy, tenant lifecycle and provider prerequisites remain authoritative.",
        "operationId": "customer_post_v1_signal_sets",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Definition"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Create Definition",
        "tags": [
          "Rules and previews"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/signals": {
      "get": {
        "description": "Returns scored rule matches, not raw observations or agent-qualified opportunities. The current list is bounded to 100 rows.",
        "operationId": "customer_get_v1_signals",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Signals",
        "tags": [
          "Workspace and observations"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/networks": {
      "get": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_get_v1_website_networks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Company Networks",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      },
      "post": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_post_v1_website_networks",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompanyNetwork"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Confirm Network",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/networks/{identifier}": {
      "delete": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_delete_v1_website_networks_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Remove Network",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ]
      }
    },
    "/v1/website/pages/{identifier}": {
      "patch": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_patch_v1_website_pages_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Override"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Override",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/pages/{identifier}/versions": {
      "get": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_get_v1_website_pages_identifier_versions",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Versions",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/sites": {
      "get": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_get_v1_website_sites",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "List Sites",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      },
      "post": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_post_v1_website_sites",
        "parameters": [
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SiteCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Create Site",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/sites/{identifier}": {
      "patch": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_patch_v1_website_sites_identifier",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SitePolicy"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Pause Site",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/sites/{identifier}/analyze": {
      "post": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_post_v1_website_sites_identifier_analyze",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Analyze",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/sites/{identifier}/pages": {
      "get": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_get_v1_website_sites_identifier_pages",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 100,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Pages",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/sites/{identifier}/rotate": {
      "post": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_post_v1_website_sites_identifier_rotate",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Rotate Site",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "admin:tenant"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "admin:tenant"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/website/visits": {
      "get": {
        "description": "Optional website preview: source/model readiness and rights still apply. Website observations remain ineligible for CRM delivery; IP network evidence is not verified employer identification.",
        "operationId": "customer_get_v1_website_visits",
        "parameters": [
          {
            "in": "query",
            "name": "page",
            "required": false,
            "schema": {
              "default": 1,
              "maximum": 10000,
              "minimum": 1,
              "title": "Page",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Recent Visits",
        "tags": [
          "Website preview"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/workflow-runs": {
      "get": {
        "description": "Returns at most 100 recent workflow runs. Inspect delivery/readback state; an accepted request is not proof of a remote side effect.",
        "operationId": "customer_get_v1_workflow_runs",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Runs",
        "tags": [
          "Reviewed workflows"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/workflows": {
      "get": {
        "description": "Returns at most 100 workflows. Only currently authorized, enabled workflows can dispatch.",
        "operationId": "customer_get_v1_workflows",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Workflows",
        "tags": [
          "Reviewed workflows"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/workflows/{identifier}/pause": {
      "post": {
        "description": "Stops future workflow dispatch and queues reconciliation. Managed HubSpot fields can be cleared when no other enabled rule qualifies. Pausing is not equivalent to stopping provider writeback or retaining CRM values on trial expiry.",
        "operationId": "customer_post_v1_workflows_identifier_pause",
        "parameters": [
          {
            "in": "path",
            "name": "identifier",
            "required": true,
            "schema": {
              "format": "uuid",
              "title": "Identifier",
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "Origin",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Required for browser-session mutations. Origin must exactly match the workspace; read the CSRF token from GET /v1/me using the browser session. A bearer-authenticated /v1/me response has csrf_token=null. Not required for bearer-token-only requests.",
            "in": "header",
            "name": "X-CSRF-Token",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Pause Workflow",
        "tags": [
          "Reviewed workflows"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "write:workflows"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "write:workflows"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    },
    "/v1/writebacks": {
      "get": {
        "description": "Returns at most 100 managed company outputs with desired/delivered revisions and delivery-job state. A receipt verifies only its matching delivered revision.",
        "operationId": "customer_get_v1_writebacks",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "description": "Missing, expired or invalid workspace authentication."
          },
          "403": {
            "description": "Missing permission, browser-session requirement or CSRF validation failure."
          },
          "423": {
            "description": "Workspace lifecycle currently denies activity."
          },
          "503": {
            "description": "Workspace control or required dependency unavailable."
          }
        },
        "security": [
          {
            "TenantBearer": []
          },
          {
            "TenantSession": []
          }
        ],
        "summary": "Writebacks",
        "tags": [
          "HubSpot"
        ],
        "x-authorization": {
          "kind": "tenant",
          "permissions": [
            "read:signals"
          ]
        },
        "x-release-status": "preview",
        "x-required-permissions": [
          "read:signals"
        ],
        "x-success-response-model": "not-declared-in-source"
      }
    }
  },
  "servers": [
    {
      "url": "https://workspace.example.com"
    }
  ],
  "tags": [
    {
      "name": "Governed data"
    },
    {
      "name": "HubSpot"
    },
    {
      "name": "Reviewed workflows"
    },
    {
      "name": "Rules and previews"
    },
    {
      "name": "Website preview"
    },
    {
      "name": "Workspace and observations"
    }
  ],
  "x-publication-policy": "Explicit method/path allowlist; internal/operator/agent/callback/native/LinkedIn/MCP and legacy mutation surfaces are excluded.",
  "x-release-status": "preview"
}