Dayalogs MCP tools reference

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "path": {
            "type": "string",
            "description": "Optional help path. Empty input returns the generated index. Examples: quick-start, questions/scale, questions/scale/help.md."
        },
        "keyword": {
            "type": "string",
            "description": "Optional single keyword search. Examples: smiley, csat, contact, endings."
        },
        "keywords": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Optional keyword list. When present, matching files must contain all terms."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "survey": {
            "type": "object",
            "description": "Dayalogs survey definition object."
        },
        "definition": {
            "type": "object",
            "description": "Alias for survey."
        },
        "survey_json": {
            "type": "string",
            "description": "Dayalogs survey definition encoded as a JSON string."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "config": {
            "type": "object",
            "description": "Dayalogs survey theme/style config object."
        },
        "theme": {
            "type": "object",
            "description": "Alias for config."
        },
        "definition": {
            "type": "object",
            "description": "Alias for config."
        },
        "config_json": {
            "type": "string",
            "description": "Dayalogs survey theme/style config encoded as a JSON string."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "version": {
            "type": "integer",
            "description": "Survey version number.",
            "minimum": 1
        }
    },
    "required": [
        "slug",
        "version"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "version": {
            "type": "integer",
            "description": "Optional concrete survey version. Omit to aggregate all versions.",
            "minimum": 1
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "survey": {
            "type": "object",
            "description": "Dayalogs survey definition object."
        },
        "definition": {
            "type": "object",
            "description": "Alias for survey."
        },
        "survey_json": {
            "type": "string",
            "description": "Dayalogs survey definition encoded as a JSON string."
        },
        "mode": {
            "type": "string",
            "enum": [
                "create",
                "update"
            ],
            "description": "Explicit import intent. Use create for a new logical survey or update for a new version of an existing survey. Omit only to request non-mutating intent guidance."
        },
        "survey_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Stable logical survey id. Required when mode=update; obtain it from get_survey or list_surveys."
        },
        "expected_version_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete current version_id observed before editing. Required when mode=update and used as an optimistic concurrency guard."
        },
        "validate": {
            "type": "boolean",
            "description": "Whether to validate before importing. Defaults to true."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "expected_version_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete current version_id observed immediately before this mutation. Required as an optimistic concurrency guard."
        },
        "title": {
            "type": "string",
            "description": "Optional new internal/source title. Use literals if the source-locale survey.title literal should differ."
        },
        "source_locale": {
            "type": "string",
            "description": "Optional two-letter source locale."
        },
        "supported_locales": {
            "type": "array",
            "description": "Optional full supported locale list. Must include source_locale after validation.",
            "items": {
                "type": "string"
            }
        },
        "interface_locales": {
            "type": "object",
            "description": "Optional mapping from content locale to respondent UI locale, for example {\"ru\":\"en\"}. Values: en, fr, de, nl, it, es, ca, pt, eu, gl.",
            "additionalProperties": {
                "type": "string"
            }
        },
        "interface_literals": {
            "type": [
                "object",
                "null"
            ],
            "description": "Optional per-survey overrides for public respondent UI text, keyed by content locale and public survey.renderer.* translation key.",
            "additionalProperties": {
                "type": "object",
                "additionalProperties": {
                    "type": "string"
                }
            }
        },
        "settings": {
            "type": [
                "object",
                "null"
            ],
            "description": "Optional respondent runtime settings. Use {\"navigation\":{\"allow_back\":false}} to disable respondent back navigation, or {\"quality\":{\"enabled_challenges\":{\"honeypot\":true}}} to control quality scoring inputs.",
            "additionalProperties": false,
            "properties": {
                "navigation": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                        "allow_back": {
                            "type": "boolean",
                            "description": "Whether respondents can navigate back to previous pages. Defaults to true."
                        }
                    }
                },
                "quality": {
                    "type": "object",
                    "additionalProperties": false,
                    "properties": {
                        "enabled_challenges": {
                            "type": "object",
                            "description": "Optional per-survey quality challenge toggles. Disable individual checks without removing the quality layer entirely.",
                            "additionalProperties": false,
                            "properties": {
                                "time": {
                                    "type": "boolean"
                                },
                                "paste_open_answers": {
                                    "type": "boolean"
                                },
                                "focus_away": {
                                    "type": "boolean"
                                },
                                "honeypot": {
                                    "type": "boolean"
                                },
                                "client_signal": {
                                    "type": "boolean"
                                },
                                "answer_patterns": {
                                    "type": "boolean"
                                },
                                "repeated_ip": {
                                    "type": "boolean"
                                },
                                "repeated_environment": {
                                    "type": "boolean"
                                }
                            }
                        }
                    }
                }
            }
        },
        "intro": {
            "type": "object",
            "description": "Optional complete intro object. Partial intro patches are not merged; pass the complete intro shape."
        },
        "privacy_notice": {
            "type": [
                "object",
                "null"
            ],
            "description": "Optional complete privacy notice object, or null to remove it."
        },
        "literals": {
            "type": [
                "object",
                "null"
            ],
            "description": "Optional locale-keyed literal map, or null to remove literals."
        },
        "partial_response_ttl_minutes": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Optional inactivity timeout in minutes for resumable partial attempts, or null to reset to default.",
            "minimum": 15
        }
    },
    "required": [
        "slug",
        "expected_version_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "version": {
            "type": "integer",
            "description": "Optional concrete survey version. Omit to aggregate all versions.",
            "minimum": 1
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string"
        },
        "kind": {
            "type": "string",
            "description": "Fragment kind accepted by the Dayalogs flow editor, for example header, block, question or ending."
        },
        "fragment_id": {
            "type": "string"
        },
        "expected_version_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete current version_id observed immediately before this mutation. Required as an optimistic concurrency guard."
        },
        "fragment": {
            "type": "object"
        },
        "json": {
            "type": "string",
            "description": "Alternative to fragment: JSON object string for the replacement fragment."
        }
    },
    "required": [
        "slug",
        "kind",
        "fragment_id",
        "expected_version_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "expected_version_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete current version_id observed immediately before this mutation. Required as an optimistic concurrency guard."
        },
        "block": {
            "type": "object",
            "description": "New top-level block object to insert at the survey root. The block may contain nested blocks and question references; pass new question definitions in questions."
        },
        "questions": {
            "type": "array",
            "description": "Optional new question definitions to add to the survey question catalog before inserting the block.",
            "items": {
                "type": "object"
            }
        },
        "position": {
            "type": "string",
            "enum": [
                "start",
                "end"
            ],
            "description": "Insert at the beginning or end of the top-level survey blocks. Defaults to end."
        },
        "after_block_id": {
            "type": "string",
            "description": "Optional existing top-level block id after which the new block should be inserted."
        },
        "before_block_id": {
            "type": "string",
            "description": "Optional existing top-level block id before which the new block should be inserted."
        }
    },
    "required": [
        "slug",
        "expected_version_id",
        "block"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "expected_version_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete current version_id observed immediately before this mutation. Required as an optimistic concurrency guard."
        },
        "block_id": {
            "type": "string",
            "description": "Existing block id that will receive the new item."
        },
        "item": {
            "type": "object",
            "description": "Flow item to insert: a nested block object or {type:\"question\", question:\"q1\"}. Use block.presentation.mode=\"grouped\" when direct questions must share one screen."
        },
        "questions": {
            "type": "array",
            "description": "Optional new question definitions to add to the survey question catalog before inserting the item.",
            "items": {
                "type": "object"
            }
        },
        "position": {
            "type": "string",
            "enum": [
                "start",
                "end"
            ],
            "description": "Insert at the beginning or end of the target block items. Defaults to end."
        },
        "after_item_id": {
            "type": "string",
            "description": "Optional existing item id/question id after which the new item should be inserted."
        },
        "before_item_id": {
            "type": "string",
            "description": "Optional existing item id/question id before which the new item should be inserted."
        }
    },
    "required": [
        "slug",
        "expected_version_id",
        "block_id",
        "item"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "target_locale": {
            "type": "string",
            "description": "Optional target locale to include existing target text in each returned entry."
        },
        "locale": {
            "type": "string",
            "description": "Alias for target_locale."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "include_entries": {
            "type": "boolean",
            "description": "Include source/target entries for each locale. Defaults to false."
        },
        "include_literals": {
            "type": "boolean",
            "description": "Alias for include_entries."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "locale": {
            "type": "string",
            "description": "Two-letter target locale, for example es or en."
        },
        "target_locale": {
            "type": "string",
            "description": "Alias for locale."
        },
        "source_hash": {
            "type": "string",
            "description": "Optional source hash returned by get_translation_source. If present, Dayalogs rejects stale saves."
        },
        "translations": {
            "type": "object",
            "description": "Complete translation map keyed by literal key, for example {\"survey.title\":\"...\"}."
        },
        "literals": {
            "type": "object",
            "description": "Alias for translations."
        },
        "entries": {
            "type": "array",
            "description": "Alternative translation shape: array of {key,target} entries returned by get_translation_source.",
            "items": {
                "type": "object"
            }
        }
    },
    "required": [
        "slug",
        "locale"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "locale": {
            "type": "string",
            "description": "Two-letter target locale, for example es or en. This value is also used in the save URL."
        },
        "target_locale": {
            "type": "string",
            "description": "Alias for locale."
        },
        "source_hash": {
            "type": "string",
            "description": "Optional source hash returned by get_translation_source. If present, Dayalogs rejects stale saves."
        },
        "translations": {
            "type": "object",
            "description": "Complete translation map keyed by literal key, for example {\"survey.title\":\"...\"}."
        },
        "literals": {
            "type": "object",
            "description": "Alias for translations."
        },
        "entries": {
            "type": "array",
            "description": "Alternative translation shape: array of {key,target} entries returned by get_translation_source.",
            "items": {
                "type": "object"
            }
        }
    },
    "required": [
        "slug",
        "locale"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string"
        },
        "locale": {
            "type": "string",
            "description": "Optional locale, for example ca, es or en."
        },
        "ttl_minutes": {
            "type": "integer",
            "description": "Public preview lifetime between 15 and 10080 minutes.",
            "minimum": 15,
            "maximum": 10080
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "style": {
            "type": [
                "string",
                "object",
                "null"
            ],
            "description": "Style assignment: none/default, base:{key}, theme:{id}, or {type:\"base\", key:\"...\"} / {type:\"theme\", id:123}."
        },
        "style_selection": {
            "type": [
                "string",
                "object",
                "null"
            ],
            "description": "Alias for style."
        },
        "base_key": {
            "type": "string",
            "description": "Assign a locked base style by key."
        },
        "style_base_key": {
            "type": "string",
            "description": "Alias for base_key."
        },
        "theme_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Assign a ready custom style by id."
        },
        "style_theme_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for theme_id."
        },
        "clear_style": {
            "type": "boolean",
            "description": "Clear the explicit survey style and fall back to the default."
        },
        "logo_alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Survey-level logo alignment override."
        },
        "alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Alias for logo_alignment."
        },
        "clear_logo_alignment": {
            "type": "boolean",
            "description": "Clear the survey-level logo alignment override and inherit the account default."
        },
        "logo_mode": {
            "type": "string",
            "enum": [
                "inherit",
                "override",
                "disabled"
            ],
            "description": "Survey logo behavior: inherit the account/default logo, use the uploaded survey logo, or hide the logo."
        },
        "header_logo_mode": {
            "type": "string",
            "enum": [
                "inherit",
                "override",
                "disabled"
            ],
            "description": "Alias for logo_mode."
        },
        "disable_logo": {
            "type": "boolean",
            "description": "Hide the header logo on this survey."
        },
        "hide_logo": {
            "type": "boolean",
            "description": "Alias for disable_logo."
        },
        "inherit_logo": {
            "type": "boolean",
            "description": "Return to the account/default header logo."
        },
        "clear_logo_override": {
            "type": "boolean",
            "description": "Alias for inherit_logo."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "content_base64": {
            "type": "string",
            "description": "Base64 image content. Data URLs are accepted."
        },
        "filename": {
            "type": "string",
            "description": "Original filename for metadata."
        },
        "mime_type": {
            "type": "string",
            "description": "image/png, image/jpeg or image/webp. Optional when content_base64 is a data URL."
        },
        "logo_alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Optional logo alignment to save with the upload."
        },
        "alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Alias for logo_alignment."
        }
    },
    "required": [
        "slug",
        "content_base64"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "confirm_publish": {
            "type": "boolean",
            "description": "Must be true to start real response collection. Set it only after the user explicitly asks to start collection, publish, or go live."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "quota_id": {
            "type": "string",
            "description": "Optional stable quota id. Defaults to a slugified label."
        },
        "id": {
            "type": "string",
            "description": "Alias for quota_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Quota display name. Required on create."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "Quota threshold."
        },
        "count": {
            "type": "integer",
            "minimum": 0,
            "description": "Current accepted count. Optional; defaults to 0 on create."
        },
        "active": {
            "type": "boolean",
            "description": "Whether the quota is active. Defaults to true on create."
        },
        "condition": {
            "type": "object",
            "description": "Dayalogs condition JSON. Use {question, op, value}, {var, op, value}, groups {all:[...]}, {any:[...]}, or {not:{...}}. Operators are normalized to canonical forms such as eq, not_eq, contains, gt, gte, lt, lte, answered and not_answered."
        },
        "if": {
            "type": "object",
            "description": "Alias for condition."
        },
        "condition_json": {
            "type": "string",
            "description": "Alternative to condition: JSON object string."
        },
        "clear_condition": {
            "type": "boolean",
            "description": "On update, remove the quota condition and turn it into a total survey quota."
        }
    },
    "required": [
        "slug",
        "label",
        "limit"
    ]
}

{
    "type": "object",
    "properties": {
        "quota_id": {
            "type": "string",
            "description": "Survey-level quota id."
        },
        "id": {
            "type": "string",
            "description": "Alias for quota_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Quota display name. Required on create."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "description": "Quota threshold."
        },
        "count": {
            "type": "integer",
            "minimum": 0,
            "description": "Current accepted count. Optional; defaults to 0 on create."
        },
        "active": {
            "type": "boolean",
            "description": "Whether the quota is active. Defaults to true on create."
        },
        "condition": {
            "type": "object",
            "description": "Dayalogs condition JSON. Use {question, op, value}, {var, op, value}, groups {all:[...]}, {any:[...]}, or {not:{...}}. Operators are normalized to canonical forms such as eq, not_eq, contains, gt, gte, lt, lte, answered and not_answered."
        },
        "if": {
            "type": "object",
            "description": "Alias for condition."
        },
        "condition_json": {
            "type": "string",
            "description": "Alternative to condition: JSON object string."
        },
        "clear_condition": {
            "type": "boolean",
            "description": "On update, remove the quota condition and turn it into a total survey quota."
        }
    },
    "required": [
        "slug",
        "quota_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "quota_id": {
            "type": "string",
            "description": "Survey-level quota id."
        },
        "id": {
            "type": "string",
            "description": "Alias for quota_id."
        }
    },
    "required": [
        "slug",
        "quota_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "version": {
            "type": "integer",
            "minimum": 1,
            "description": "Concrete survey version number."
        },
        "included": {
            "type": "boolean",
            "description": "false excludes this version contribution; true restores it."
        },
        "quota_id": {
            "type": "string",
            "description": "Optional quota id. Omit to apply to every survey-level quota."
        },
        "reason": {
            "type": "string",
            "description": "Audit reason. Required when excluding a version."
        },
        "confirm_exclusion": {
            "type": "boolean",
            "description": "Must be true when included=false, after the user explicitly confirms excluding this version from quota progress."
        }
    },
    "required": [
        "slug",
        "version",
        "included"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "version": {
            "type": [
                "string",
                "integer"
            ],
            "description": "current, all or a specific version number. Defaults to current."
        },
        "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Page number. Defaults to 1."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Responses per page. Defaults to 25, maximum 100."
        },
        "submitted_from": {
            "type": "string",
            "description": "Optional ISO-8601 lower datetime bound."
        },
        "submitted_to": {
            "type": "string",
            "description": "Optional ISO-8601 upper datetime bound."
        },
        "ending_key": {
            "type": "string",
            "description": "Optional ending key filter."
        },
        "share_link_id": {
            "type": "integer",
            "description": "Optional share-link id filter."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "response_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Survey response id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for response_id."
        }
    },
    "required": [
        "slug",
        "response_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "response_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Survey response id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for response_id."
        }
    },
    "required": [
        "slug",
        "response_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "format": {
            "type": "string",
            "enum": [
                "json",
                "ndjson",
                "csv",
                "xlsx",
                "sav"
            ],
            "description": "Export format. Defaults to json."
        },
        "versions": {
            "type": [
                "string",
                "integer",
                "array"
            ],
            "items": {
                "type": "integer"
            },
            "description": "current, all, one version number, comma-separated version numbers, or an array of version numbers. Defaults to current."
        },
        "version": {
            "type": [
                "string",
                "integer"
            ],
            "description": "Alias for versions when selecting a single version/current/all."
        },
        "attempts": {
            "type": "string",
            "enum": [
                "completed",
                "all",
                "partials"
            ],
            "description": "Whether to export completed responses, partial attempts, or both. Defaults to completed."
        },
        "partial_min_completion_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Optional minimum completion percent when partial attempts are included."
        },
        "partial_reached_target": {
            "type": "string",
            "description": "Optional question id/code/alias that a partial attempt must have reached."
        },
        "option_value_mode": {
            "type": "string",
            "enum": [
                "code",
                "alias"
            ],
            "description": "Use option numeric codes or option aliases in tabular exports when aliases exist."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "q": {
            "type": "string",
            "description": "Optional text search across name, email, phone, external id and UUID."
        },
        "query": {
            "type": "string",
            "description": "Alias for q."
        },
        "tags": {
            "type": [
                "array",
                "string"
            ],
            "items": {
                "type": "string"
            },
            "description": "Optional tag slugs/names. Multiple tags are combined with AND. Accepts an array or comma-separated string."
        },
        "tag_slugs": {
            "type": [
                "array",
                "string"
            ],
            "items": {
                "type": "string"
            },
            "description": "Alias for tags."
        },
        "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Page number. Defaults to 1."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Contacts per page. Defaults to 20, maximum 100."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "contact_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience contact id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for contact_id."
        }
    },
    "required": [
        "contact_id"
    ]
}

{
    "type": "object",
    "properties": {
        "label": {
            "type": "string",
            "description": "Human import name, for example \"Directors escoles juny 2026\"."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "tags": {
            "type": [
                "array",
                "string"
            ],
            "items": {
                "type": "string"
            },
            "description": "Optional import tags as array or comma-separated string. Dayalogs also adds an import-YYMMDD-HHMM tag automatically."
        },
        "tag_names": {
            "type": [
                "array",
                "string"
            ],
            "items": {
                "type": "string"
            },
            "description": "Alias for tags."
        },
        "data_survey_slug": {
            "type": "string",
            "description": "Optional survey slug. When set, each contact data object is stored as survey-scoped @contact.survey_data for that survey."
        },
        "survey_slug": {
            "type": "string",
            "description": "Alias for data_survey_slug."
        },
        "source_metadata": {
            "type": "object",
            "description": "Optional metadata about the upstream source, such as CRM name, file title or agent trace id."
        },
        "metadata": {
            "type": "object",
            "description": "Alias for source_metadata."
        }
    },
    "required": [
        "label"
    ]
}

{
    "type": "object",
    "properties": {
        "import_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience import id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for import_id."
        },
        "chunk_id": {
            "type": "string",
            "description": "Optional idempotency key. Re-sending the same chunk_id is a no-op."
        },
        "contacts": {
            "type": "array",
            "description": "Chunk of already-normalized Dayalogs contact JSON objects. Do not send raw Excel/CSV rows here.",
            "items": {
                "type": "object",
                "description": "Normalized contact object. Canonical fields: external_id, email, phone, first_name, last_name, full_name, age, gender, tags, extra, data, survey_data.",
                "properties": {
                    "external_id": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "phone": {
                        "type": "string"
                    },
                    "first_name": {
                        "type": "string"
                    },
                    "last_name": {
                        "type": "string"
                    },
                    "full_name": {
                        "type": "string"
                    },
                    "age": {
                        "type": [
                            "integer",
                            "string"
                        ]
                    },
                    "gender": {
                        "type": "string"
                    },
                    "tags": {
                        "type": [
                            "array",
                            "string"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "extra": {
                        "type": "object",
                        "description": "Unmapped flat or structured metadata. Exposed under @contact.extra and merged into contact payload."
                    },
                    "data": {
                        "type": "object",
                        "description": "Structured account-level contact data, or survey-scoped data when the import session has data_survey_slug."
                    },
                    "survey_data": {
                        "type": "object",
                        "description": "Optional object keyed by survey slug, each value a JSON object."
                    }
                }
            }
        },
        "items": {
            "type": "array",
            "description": "Alias for contacts.",
            "items": {
                "type": "object",
                "description": "Normalized contact object. Canonical fields: external_id, email, phone, first_name, last_name, full_name, age, gender, tags, extra, data, survey_data.",
                "properties": {
                    "external_id": {
                        "type": "string"
                    },
                    "email": {
                        "type": "string"
                    },
                    "phone": {
                        "type": "string"
                    },
                    "first_name": {
                        "type": "string"
                    },
                    "last_name": {
                        "type": "string"
                    },
                    "full_name": {
                        "type": "string"
                    },
                    "age": {
                        "type": [
                            "integer",
                            "string"
                        ]
                    },
                    "gender": {
                        "type": "string"
                    },
                    "tags": {
                        "type": [
                            "array",
                            "string"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "extra": {
                        "type": "object",
                        "description": "Unmapped flat or structured metadata. Exposed under @contact.extra and merged into contact payload."
                    },
                    "data": {
                        "type": "object",
                        "description": "Structured account-level contact data, or survey-scoped data when the import session has data_survey_slug."
                    },
                    "survey_data": {
                        "type": "object",
                        "description": "Optional object keyed by survey slug, each value a JSON object."
                    }
                }
            }
        },
        "contacts_json": {
            "type": "string",
            "description": "Alternative to contacts: JSON string containing an array of normalized contact objects."
        }
    },
    "required": [
        "import_id"
    ]
}

{
    "type": "object",
    "properties": {
        "import_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience import id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for import_id."
        }
    },
    "required": [
        "import_id"
    ]
}

{
    "type": "object",
    "properties": {
        "import_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience import id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for import_id."
        }
    },
    "required": [
        "import_id"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "q": {
            "type": "string",
            "description": "Text to search in tag name or slug."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 25,
            "description": "Maximum suggestions. Defaults to 8."
        }
    },
    "required": [
        "q"
    ]
}

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Tag display name."
        },
        "slug": {
            "type": "string",
            "description": "Optional stable slug. Defaults to a slugified name on create."
        }
    },
    "required": [
        "name"
    ]
}

{
    "type": "object",
    "properties": {
        "tag_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Tag id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for tag_id."
        },
        "name": {
            "type": "string",
            "description": "Tag display name."
        },
        "slug": {
            "type": "string",
            "description": "Optional stable slug. Defaults to a slugified name on create."
        }
    },
    "required": [
        "tag_id"
    ]
}

{
    "type": "object",
    "properties": {
        "tag_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Tag id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for tag_id."
        },
        "detach": {
            "type": "boolean",
            "description": "When true, delete even if assigned to contacts, detaching those contact assignments."
        }
    },
    "required": [
        "tag_id"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "criteria": {
            "type": "object",
            "description": "Segment query object using combinator and rules. Rule sources: tag, field, extra, data, survey_data. Canonical operators: exists, not_exists, eq, not_eq, contains, not_contains, starts_with, ends_with, gt, gte, lt, lte, count_eq, count_gt, count_gte, count_lt, count_lte."
        },
        "criteria_json": {
            "type": "string",
            "description": "Alternative to criteria: JSON string containing the segment query object."
        },
        "sample_limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Maximum sample contacts to return. Defaults to 5."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Segment display name. Required on create."
        },
        "slug": {
            "type": "string",
            "description": "Optional stable slug. Defaults to a slugified name on create."
        },
        "description": {
            "type": "string",
            "description": "Optional internal description."
        },
        "criteria": {
            "type": "object",
            "description": "Segment query object using combinator and rules. Rule sources: tag, field, extra, data, survey_data. Canonical operators: exists, not_exists, eq, not_eq, contains, not_contains, starts_with, ends_with, gt, gte, lt, lte, count_eq, count_gt, count_gte, count_lt, count_lte."
        },
        "criteria_json": {
            "type": "string",
            "description": "Alternative to criteria: JSON string containing the segment query object."
        },
        "refresh_count": {
            "type": "boolean",
            "description": "On update, recalculate last_count even when criteria is unchanged."
        }
    },
    "required": [
        "name"
    ]
}

{
    "type": "object",
    "properties": {
        "segment_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience segment id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for segment_id."
        },
        "name": {
            "type": "string",
            "description": "Segment display name. Required on create."
        },
        "slug": {
            "type": "string",
            "description": "Optional stable slug. Defaults to a slugified name on create."
        },
        "description": {
            "type": "string",
            "description": "Optional internal description."
        },
        "criteria": {
            "type": "object",
            "description": "Segment query object using combinator and rules. Rule sources: tag, field, extra, data, survey_data. Canonical operators: exists, not_exists, eq, not_eq, contains, not_contains, starts_with, ends_with, gt, gte, lt, lte, count_eq, count_gt, count_gte, count_lt, count_lte."
        },
        "criteria_json": {
            "type": "string",
            "description": "Alternative to criteria: JSON string containing the segment query object."
        },
        "refresh_count": {
            "type": "boolean",
            "description": "On update, recalculate last_count even when criteria is unchanged."
        }
    },
    "required": [
        "segment_id"
    ]
}

{
    "type": "object",
    "properties": {
        "segment_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Audience segment id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for segment_id."
        }
    },
    "required": [
        "segment_id"
    ]
}

{
    "type": "object",
    "properties": {
        "source": {
            "type": "string",
            "enum": [
                "extra",
                "data",
                "survey_data"
            ],
            "description": "JSON source to inspect."
        },
        "survey_slug": {
            "type": "string",
            "description": "Required when source is survey_data."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "Maximum paths to return. Defaults to 250."
        }
    },
    "required": [
        "source"
    ]
}

{
    "type": "object",
    "properties": {
        "source": {
            "type": "string",
            "enum": [
                "field",
                "extra",
                "data",
                "survey_data"
            ],
            "description": "Source to inspect for existing values."
        },
        "field": {
            "type": "string",
            "description": "Required when source is field. Example: email, full_name, age, gender."
        },
        "path": {
            "type": "string",
            "description": "Required for extra, data and survey_data sources."
        },
        "survey_slug": {
            "type": "string",
            "description": "Required when source is survey_data."
        },
        "q": {
            "type": "string",
            "description": "Optional autocomplete query."
        },
        "query": {
            "type": "string",
            "description": "Alias for q."
        }
    },
    "required": [
        "source"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Display label. Optional on create; defaults to the contact display name or \"Single link\"."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "contact_id": {
            "type": "integer",
            "description": "Optional contact id. If present, Dayalogs creates a personalized link."
        },
        "email": {
            "type": "string",
            "description": "Optional email metadata for anonymous single links."
        },
        "tag_id": {
            "type": "integer",
            "description": "Optional source tag id for personalized single links."
        },
        "tag_slug": {
            "type": "string",
            "description": "Optional source tag slug for personalized single links."
        },
        "source_tag_id": {
            "type": "integer",
            "description": "Alias for tag_id."
        },
        "source_tag_slug": {
            "type": "string",
            "description": "Alias for tag_slug."
        },
        "single_response": {
            "type": "boolean",
            "description": "For personalized links, one response per link with server-side resume. Defaults to true for multi-link link sets and false for single-link link sets."
        },
        "cookie_protection": {
            "type": "boolean",
            "description": "Anonymous single-link soft duplicate guard. Ignored for personalized multi-link link sets."
        },
        "inactivity_timeout_seconds": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 30,
            "description": "Kiosk/shared-device mode: seconds of inactivity before the current attempt is saved as a partial and the survey restarts for the next respondent, with a visible countdown warning first. Use for tablets at counters or event kiosks. Minimum 30. Only applies to anonymous multi-response links without cookie_protection; ignored elsewhere. Null disables it."
        },
        "embedded_variables": {
            "type": "object",
            "description": "Server-side variables stored with response metadata and never exposed in the URL."
        },
        "variables": {
            "type": "object",
            "description": "Alias for embedded_variables."
        },
        "url_variables": {
            "type": "object",
            "description": "Static query parameters appended to generated URLs; visible and modifiable by respondents."
        },
        "url_params": {
            "type": "object",
            "description": "Alias for url_variables."
        },
        "quota": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Quota threshold. For multi-link link sets, only applies when single_response is false."
        },
        "limit": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Alias for quota."
        },
        "quota_count": {
            "type": "integer",
            "description": "Current accepted count. Usually edited after fieldwork starts."
        },
        "count": {
            "type": "integer",
            "description": "Alias for quota_count."
        },
        "clear_quota": {
            "type": "boolean",
            "description": "Remove the quota threshold where quotas are editable."
        },
        "open_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 activation datetime."
        },
        "open_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for open_at."
        },
        "close_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 deactivation datetime."
        },
        "close_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for close_at."
        },
        "confirm_real_link": {
            "type": "boolean",
            "description": "Must be true to create a real respondent access link. Use get_preview_url instead for user review links."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "link_id": {
            "type": "integer",
            "description": "Survey link id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Display label. Optional on create; defaults to the contact display name or \"Single link\"."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "contact_id": {
            "type": "integer",
            "description": "Optional contact id. If present, Dayalogs creates a personalized link."
        },
        "email": {
            "type": "string",
            "description": "Optional email metadata for anonymous single links."
        },
        "tag_id": {
            "type": "integer",
            "description": "Optional source tag id for personalized single links."
        },
        "tag_slug": {
            "type": "string",
            "description": "Optional source tag slug for personalized single links."
        },
        "source_tag_id": {
            "type": "integer",
            "description": "Alias for tag_id."
        },
        "source_tag_slug": {
            "type": "string",
            "description": "Alias for tag_slug."
        },
        "single_response": {
            "type": "boolean",
            "description": "For personalized links, one response per link with server-side resume. Defaults to true for multi-link link sets and false for single-link link sets."
        },
        "cookie_protection": {
            "type": "boolean",
            "description": "Anonymous single-link soft duplicate guard. Ignored for personalized multi-link link sets."
        },
        "inactivity_timeout_seconds": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 30,
            "description": "Kiosk/shared-device mode: seconds of inactivity before the current attempt is saved as a partial and the survey restarts for the next respondent, with a visible countdown warning first. Use for tablets at counters or event kiosks. Minimum 30. Only applies to anonymous multi-response links without cookie_protection; ignored elsewhere. Null disables it."
        },
        "embedded_variables": {
            "type": "object",
            "description": "Server-side variables stored with response metadata and never exposed in the URL."
        },
        "variables": {
            "type": "object",
            "description": "Alias for embedded_variables."
        },
        "url_variables": {
            "type": "object",
            "description": "Static query parameters appended to generated URLs; visible and modifiable by respondents."
        },
        "url_params": {
            "type": "object",
            "description": "Alias for url_variables."
        },
        "quota": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Quota threshold. For multi-link link sets, only applies when single_response is false."
        },
        "limit": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Alias for quota."
        },
        "quota_count": {
            "type": "integer",
            "description": "Current accepted count. Usually edited after fieldwork starts."
        },
        "count": {
            "type": "integer",
            "description": "Alias for quota_count."
        },
        "clear_quota": {
            "type": "boolean",
            "description": "Remove the quota threshold where quotas are editable."
        },
        "open_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 activation datetime."
        },
        "open_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for open_at."
        },
        "close_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 deactivation datetime."
        },
        "close_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for close_at."
        }
    },
    "required": [
        "slug",
        "link_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_id": {
            "type": "integer",
            "description": "Survey link id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_id."
        }
    },
    "required": [
        "slug",
        "link_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_id": {
            "type": "integer",
            "description": "Survey link id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_id."
        }
    },
    "required": [
        "slug",
        "link_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_id": {
            "type": "integer",
            "description": "Survey link id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_id."
        }
    },
    "required": [
        "slug",
        "link_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Link set display name. Required on create."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "source_type": {
            "type": "string",
            "enum": [
                "tag",
                "segment",
                "contacts"
            ],
            "description": "Create source. On create, Dayalogs can infer this from tag_id/tag_slug, segment_id/segment_slug or contact_ids."
        },
        "source": {
            "type": "string",
            "description": "Alias for source_type."
        },
        "tag_id": {
            "type": "integer",
            "description": "Source tag id."
        },
        "tag_slug": {
            "type": "string",
            "description": "Source tag slug."
        },
        "source_tag_id": {
            "type": "integer",
            "description": "Alias for tag_id."
        },
        "source_tag_slug": {
            "type": "string",
            "description": "Alias for tag_slug."
        },
        "segment_id": {
            "type": "integer",
            "description": "Source audience segment id."
        },
        "segment_slug": {
            "type": "string",
            "description": "Source audience segment slug."
        },
        "source_segment_id": {
            "type": "integer",
            "description": "Alias for segment_id."
        },
        "source_segment_slug": {
            "type": "string",
            "description": "Alias for segment_slug."
        },
        "contact_ids": {
            "type": "array",
            "description": "Explicit contact ids for source_type contacts.",
            "items": {
                "type": "integer"
            }
        },
        "contacts": {
            "type": "array",
            "description": "Alias for contact_ids. Can be integers or objects with id/contact_id.",
            "items": {
                "type": [
                    "integer",
                    "object"
                ]
            }
        },
        "quota_scope": {
            "type": "string",
            "enum": [
                "per_link",
                "global"
            ],
            "description": "Quota mode for multi-link link sets. Defaults to per_link."
        },
        "quota_mode": {
            "type": "string",
            "description": "Alias for quota_scope."
        },
        "overwrite_calendar_overrides": {
            "type": "boolean",
            "description": "On update, apply date changes to links with custom date overrides too."
        },
        "overwrite_quota_overrides": {
            "type": "boolean",
            "description": "On update, apply per-link quota changes to links with custom quota overrides too."
        },
        "single_response": {
            "type": "boolean",
            "description": "For personalized links, one response per link with server-side resume. Defaults to true for multi-link link sets and false for single-link link sets."
        },
        "cookie_protection": {
            "type": "boolean",
            "description": "Anonymous single-link soft duplicate guard. Ignored for personalized multi-link link sets."
        },
        "inactivity_timeout_seconds": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 30,
            "description": "Kiosk/shared-device mode: seconds of inactivity before the current attempt is saved as a partial and the survey restarts for the next respondent, with a visible countdown warning first. Use for tablets at counters or event kiosks. Minimum 30. Only applies to anonymous multi-response links without cookie_protection; ignored elsewhere. Null disables it."
        },
        "embedded_variables": {
            "type": "object",
            "description": "Server-side variables stored with response metadata and never exposed in the URL."
        },
        "variables": {
            "type": "object",
            "description": "Alias for embedded_variables."
        },
        "url_variables": {
            "type": "object",
            "description": "Static query parameters appended to generated URLs; visible and modifiable by respondents."
        },
        "url_params": {
            "type": "object",
            "description": "Alias for url_variables."
        },
        "quota": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Quota threshold. For multi-link link sets, only applies when single_response is false."
        },
        "limit": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Alias for quota."
        },
        "quota_count": {
            "type": "integer",
            "description": "Current accepted count. Usually edited after fieldwork starts."
        },
        "count": {
            "type": "integer",
            "description": "Alias for quota_count."
        },
        "clear_quota": {
            "type": "boolean",
            "description": "Remove the quota threshold where quotas are editable."
        },
        "open_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 activation datetime."
        },
        "open_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for open_at."
        },
        "close_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 deactivation datetime."
        },
        "close_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for close_at."
        }
    },
    "required": [
        "slug",
        "label"
    ]
}

{
    "type": "object",
    "properties": {
        "link_set_id": {
            "type": "integer",
            "description": "Survey link set id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_set_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "label": {
            "type": "string",
            "description": "Link set display name. Required on create."
        },
        "name": {
            "type": "string",
            "description": "Alias for label."
        },
        "source_type": {
            "type": "string",
            "enum": [
                "tag",
                "segment",
                "contacts"
            ],
            "description": "Create source. On create, Dayalogs can infer this from tag_id/tag_slug, segment_id/segment_slug or contact_ids."
        },
        "source": {
            "type": "string",
            "description": "Alias for source_type."
        },
        "tag_id": {
            "type": "integer",
            "description": "Source tag id."
        },
        "tag_slug": {
            "type": "string",
            "description": "Source tag slug."
        },
        "source_tag_id": {
            "type": "integer",
            "description": "Alias for tag_id."
        },
        "source_tag_slug": {
            "type": "string",
            "description": "Alias for tag_slug."
        },
        "segment_id": {
            "type": "integer",
            "description": "Source audience segment id."
        },
        "segment_slug": {
            "type": "string",
            "description": "Source audience segment slug."
        },
        "source_segment_id": {
            "type": "integer",
            "description": "Alias for segment_id."
        },
        "source_segment_slug": {
            "type": "string",
            "description": "Alias for segment_slug."
        },
        "contact_ids": {
            "type": "array",
            "description": "Explicit contact ids for source_type contacts.",
            "items": {
                "type": "integer"
            }
        },
        "contacts": {
            "type": "array",
            "description": "Alias for contact_ids. Can be integers or objects with id/contact_id.",
            "items": {
                "type": [
                    "integer",
                    "object"
                ]
            }
        },
        "quota_scope": {
            "type": "string",
            "enum": [
                "per_link",
                "global"
            ],
            "description": "Quota mode for multi-link link sets. Defaults to per_link."
        },
        "quota_mode": {
            "type": "string",
            "description": "Alias for quota_scope."
        },
        "overwrite_calendar_overrides": {
            "type": "boolean",
            "description": "On update, apply date changes to links with custom date overrides too."
        },
        "overwrite_quota_overrides": {
            "type": "boolean",
            "description": "On update, apply per-link quota changes to links with custom quota overrides too."
        },
        "single_response": {
            "type": "boolean",
            "description": "For personalized links, one response per link with server-side resume. Defaults to true for multi-link link sets and false for single-link link sets."
        },
        "cookie_protection": {
            "type": "boolean",
            "description": "Anonymous single-link soft duplicate guard. Ignored for personalized multi-link link sets."
        },
        "inactivity_timeout_seconds": {
            "type": [
                "integer",
                "null"
            ],
            "minimum": 30,
            "description": "Kiosk/shared-device mode: seconds of inactivity before the current attempt is saved as a partial and the survey restarts for the next respondent, with a visible countdown warning first. Use for tablets at counters or event kiosks. Minimum 30. Only applies to anonymous multi-response links without cookie_protection; ignored elsewhere. Null disables it."
        },
        "embedded_variables": {
            "type": "object",
            "description": "Server-side variables stored with response metadata and never exposed in the URL."
        },
        "variables": {
            "type": "object",
            "description": "Alias for embedded_variables."
        },
        "url_variables": {
            "type": "object",
            "description": "Static query parameters appended to generated URLs; visible and modifiable by respondents."
        },
        "url_params": {
            "type": "object",
            "description": "Alias for url_variables."
        },
        "quota": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Quota threshold. For multi-link link sets, only applies when single_response is false."
        },
        "limit": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Alias for quota."
        },
        "quota_count": {
            "type": "integer",
            "description": "Current accepted count. Usually edited after fieldwork starts."
        },
        "count": {
            "type": "integer",
            "description": "Alias for quota_count."
        },
        "clear_quota": {
            "type": "boolean",
            "description": "Remove the quota threshold where quotas are editable."
        },
        "open_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 activation datetime."
        },
        "open_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for open_at."
        },
        "close_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional ISO-8601 deactivation datetime."
        },
        "close_date": {
            "type": [
                "string",
                "null"
            ],
            "description": "Alias for close_at."
        }
    },
    "required": [
        "slug",
        "link_set_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Survey link set id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_set_id."
        }
    },
    "required": [
        "slug",
        "link_set_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Survey link set id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_set_id."
        }
    },
    "required": [
        "slug",
        "link_set_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Survey link set id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_set_id."
        }
    },
    "required": [
        "slug",
        "link_set_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Survey link set id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for link_set_id."
        },
        "format": {
            "type": "string",
            "enum": [
                "json",
                "csv",
                "xlsx"
            ],
            "description": "Export format. Defaults to json."
        }
    },
    "required": [
        "slug",
        "link_set_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "maxLength": 160,
            "description": "Human-readable placement name."
        },
        "share_link_id": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Optional anonymous reusable single-link link set id for this survey. Fixed metadata, dates, quota and cookie protection remain effective at runtime. Null resolves or creates the survey default link."
        },
        "allowed_origins": {
            "type": "array",
            "description": "Exact HTTP(S) origins or wildcard subdomain origins such as https://*.example.com. Never use *.",
            "items": {
                "type": "string"
            }
        },
        "origins": {
            "type": "array",
            "description": "Alias for allowed_origins.",
            "items": {
                "type": "string"
            }
        },
        "settings": {
            "type": "object",
            "properties": {
                "mode": {
                    "type": "string",
                    "enum": [
                        "modal"
                    ]
                },
                "trigger": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "immediate",
                                "delay",
                                "scroll",
                                "launcher",
                                "programmatic",
                                "custom_event"
                            ]
                        },
                        "delay_ms": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 3600000
                        },
                        "scroll_percent": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        },
                        "event_name": {
                            "type": "string",
                            "maxLength": 120
                        },
                        "launcher_label": {
                            "type": "string",
                            "maxLength": 120
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "frequency": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "always",
                                "session",
                                "once",
                                "cooldown"
                            ]
                        },
                        "cooldown_days": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 3650
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "layout": {
                    "type": "object",
                    "properties": {
                        "desktop_width": {
                            "type": "integer",
                            "minimum": 320,
                            "maximum": 1200
                        },
                        "mobile_width": {
                            "type": "integer",
                            "minimum": 280,
                            "maximum": 600
                        },
                        "max_height": {
                            "type": "integer",
                            "minimum": 320,
                            "maximum": 1600
                        },
                        "drawer_side": {
                            "type": "string",
                            "enum": [
                                "left",
                                "right"
                            ]
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "appearance": {
                    "type": "object",
                    "properties": {
                        "border_width": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 8
                        },
                        "border_color": {
                            "type": "string",
                            "pattern": "^#[0-9a-fA-F]{6}$"
                        },
                        "border_radius": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 40
                        },
                        "shadow": {
                            "type": "string",
                            "enum": [
                                "none",
                                "soft",
                                "strong"
                            ]
                        },
                        "backdrop_color": {
                            "type": "string",
                            "pattern": "^#[0-9a-fA-F]{6}$"
                        },
                        "backdrop_opacity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 90
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "target_selector": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "maxLength": 240
                },
                "locale": {
                    "type": [
                        "string",
                        "null"
                    ]
                }
            },
            "required": [],
            "additionalProperties": false
        },
        "active": {
            "type": "boolean",
            "description": "Create the placement active. At least one allowed origin is required."
        },
        "confirm_public_embed": {
            "type": "boolean",
            "description": "Set true only after the user explicitly approves activating this real public website embed."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "active",
                "revoked"
            ],
            "description": "Update lifecycle status. Activating requires at least one allowed origin."
        }
    },
    "required": [
        "slug",
        "name"
    ],
    "additionalProperties": false
}

{
    "type": "object",
    "properties": {
        "embed_id": {
            "type": "integer",
            "description": "Website embed placement id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for embed_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "maxLength": 160,
            "description": "Human-readable placement name."
        },
        "share_link_id": {
            "type": [
                "integer",
                "null"
            ],
            "description": "Optional anonymous reusable single-link link set id for this survey. Fixed metadata, dates, quota and cookie protection remain effective at runtime. Null resolves or creates the survey default link."
        },
        "allowed_origins": {
            "type": "array",
            "description": "Exact HTTP(S) origins or wildcard subdomain origins such as https://*.example.com. Never use *.",
            "items": {
                "type": "string"
            }
        },
        "origins": {
            "type": "array",
            "description": "Alias for allowed_origins.",
            "items": {
                "type": "string"
            }
        },
        "settings": {
            "type": "object",
            "properties": {
                "mode": {
                    "type": "string",
                    "enum": [
                        "modal"
                    ]
                },
                "trigger": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "immediate",
                                "delay",
                                "scroll",
                                "launcher",
                                "programmatic",
                                "custom_event"
                            ]
                        },
                        "delay_ms": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 3600000
                        },
                        "scroll_percent": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        },
                        "event_name": {
                            "type": "string",
                            "maxLength": 120
                        },
                        "launcher_label": {
                            "type": "string",
                            "maxLength": 120
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "frequency": {
                    "type": "object",
                    "properties": {
                        "type": {
                            "type": "string",
                            "enum": [
                                "always",
                                "session",
                                "once",
                                "cooldown"
                            ]
                        },
                        "cooldown_days": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 3650
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "layout": {
                    "type": "object",
                    "properties": {
                        "desktop_width": {
                            "type": "integer",
                            "minimum": 320,
                            "maximum": 1200
                        },
                        "mobile_width": {
                            "type": "integer",
                            "minimum": 280,
                            "maximum": 600
                        },
                        "max_height": {
                            "type": "integer",
                            "minimum": 320,
                            "maximum": 1600
                        },
                        "drawer_side": {
                            "type": "string",
                            "enum": [
                                "left",
                                "right"
                            ]
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "appearance": {
                    "type": "object",
                    "properties": {
                        "border_width": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 8
                        },
                        "border_color": {
                            "type": "string",
                            "pattern": "^#[0-9a-fA-F]{6}$"
                        },
                        "border_radius": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 40
                        },
                        "shadow": {
                            "type": "string",
                            "enum": [
                                "none",
                                "soft",
                                "strong"
                            ]
                        },
                        "backdrop_color": {
                            "type": "string",
                            "pattern": "^#[0-9a-fA-F]{6}$"
                        },
                        "backdrop_opacity": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 90
                        }
                    },
                    "required": [],
                    "additionalProperties": false
                },
                "target_selector": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "maxLength": 240
                },
                "locale": {
                    "type": [
                        "string",
                        "null"
                    ]
                }
            },
            "required": [],
            "additionalProperties": false
        },
        "active": {
            "type": "boolean",
            "description": "Create the placement active. At least one allowed origin is required."
        },
        "confirm_public_embed": {
            "type": "boolean",
            "description": "Set true only after the user explicitly approves activating this real public website embed."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "active",
                "revoked"
            ],
            "description": "Update lifecycle status. Activating requires at least one allowed origin."
        }
    },
    "required": [
        "slug",
        "embed_id"
    ],
    "additionalProperties": false
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "embed_id": {
            "type": "integer",
            "description": "Website embed placement id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for embed_id."
        }
    },
    "required": [
        "slug",
        "embed_id"
    ],
    "additionalProperties": false
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "include_archived": {
            "type": "boolean",
            "description": "Include archived campaigns in the list."
        },
        "archived": {
            "type": "boolean",
            "description": "Return only archived campaigns."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "include_recipients": {
            "type": "boolean",
            "description": "Include recipients. Defaults to true."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 500,
            "description": "Maximum recent events to return. Defaults to 100."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "description": "Campaign display name."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Existing multi-link link set id. Required on create."
        },
        "subject": {
            "type": "string",
            "description": "Email subject. Required on create. Supports campaign/contact/link placeholders."
        },
        "sender_name": {
            "type": "string",
            "description": "From display name. Defaults to organization name."
        },
        "sender_local_part": {
            "type": "string",
            "description": "From local part before @. Defaults to surveys."
        },
        "sender_domain": {
            "type": "string",
            "description": "Allowed sender domain. Currently dayalogs.com."
        },
        "from": {
            "type": "string",
            "description": "Alias for full from email, for example surveys@dayalogs.com."
        },
        "from_email": {
            "type": "string",
            "description": "Alias for full from email."
        },
        "from_name": {
            "type": "string",
            "description": "Alias for sender_name."
        },
        "email_template": {
            "type": "string",
            "description": "Template selector: base:dayalogs-basic, base:dayalogs-plain or custom:<id>."
        },
        "template": {
            "type": "string",
            "description": "Alias for email_template."
        },
        "email_template_id": {
            "type": "integer",
            "description": "Ready custom email template id. Alias for custom:<id>."
        },
        "template_id": {
            "type": "integer",
            "description": "Alias for email_template_id."
        },
        "email_template_base_key": {
            "type": "string",
            "description": "Base template key. Alias for base:<key>."
        },
        "template_base_key": {
            "type": "string",
            "description": "Alias for email_template_base_key."
        },
        "body_html": {
            "type": "string",
            "description": "Campaign email body HTML. Required on create. Use {{ @link.url }} or Dayalogs will append a link."
        },
        "html": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body_text": {
            "type": "string",
            "description": "Optional plain-text body override."
        },
        "text": {
            "type": "string",
            "description": "Alias for body_text."
        },
        "disclaimer_html": {
            "type": "string",
            "description": "Optional legal/disclaimer HTML. Falls back to account default."
        },
        "disclaimer": {
            "type": "string",
            "description": "Alias for disclaimer_html."
        },
        "disclaimer_text": {
            "type": "string",
            "description": "Optional plain-text disclaimer override."
        },
        "include_branding": {
            "type": "boolean",
            "description": "Whether the campaign includes account/survey branding."
        },
        "save_account_disclaimer": {
            "type": "boolean",
            "description": "Also save this disclaimer as the account default."
        }
    },
    "required": [
        "slug",
        "link_set_id",
        "subject",
        "body_html"
    ]
}

{
    "type": "object",
    "properties": {
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "description": "Campaign display name."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Existing multi-link link set id. Required on create."
        },
        "subject": {
            "type": "string",
            "description": "Email subject. Required on create. Supports campaign/contact/link placeholders."
        },
        "sender_name": {
            "type": "string",
            "description": "From display name. Defaults to organization name."
        },
        "sender_local_part": {
            "type": "string",
            "description": "From local part before @. Defaults to surveys."
        },
        "sender_domain": {
            "type": "string",
            "description": "Allowed sender domain. Currently dayalogs.com."
        },
        "from": {
            "type": "string",
            "description": "Alias for full from email, for example surveys@dayalogs.com."
        },
        "from_email": {
            "type": "string",
            "description": "Alias for full from email."
        },
        "from_name": {
            "type": "string",
            "description": "Alias for sender_name."
        },
        "email_template": {
            "type": "string",
            "description": "Template selector: base:dayalogs-basic, base:dayalogs-plain or custom:<id>."
        },
        "template": {
            "type": "string",
            "description": "Alias for email_template."
        },
        "email_template_id": {
            "type": "integer",
            "description": "Ready custom email template id. Alias for custom:<id>."
        },
        "template_id": {
            "type": "integer",
            "description": "Alias for email_template_id."
        },
        "email_template_base_key": {
            "type": "string",
            "description": "Base template key. Alias for base:<key>."
        },
        "template_base_key": {
            "type": "string",
            "description": "Alias for email_template_base_key."
        },
        "body_html": {
            "type": "string",
            "description": "Campaign email body HTML. Required on create. Use {{ @link.url }} or Dayalogs will append a link."
        },
        "html": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body_text": {
            "type": "string",
            "description": "Optional plain-text body override."
        },
        "text": {
            "type": "string",
            "description": "Alias for body_text."
        },
        "disclaimer_html": {
            "type": "string",
            "description": "Optional legal/disclaimer HTML. Falls back to account default."
        },
        "disclaimer": {
            "type": "string",
            "description": "Alias for disclaimer_html."
        },
        "disclaimer_text": {
            "type": "string",
            "description": "Optional plain-text disclaimer override."
        },
        "include_branding": {
            "type": "boolean",
            "description": "Whether the campaign includes account/survey branding."
        },
        "save_account_disclaimer": {
            "type": "boolean",
            "description": "Also save this disclaimer as the account default."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Source campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "name": {
            "type": "string",
            "description": "Optional clone name. If omitted, Dayalogs creates a copy name."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "campaign_id": {
            "type": "integer",
            "description": "Optional saved campaign id. If present, draft fields are ignored."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "description": "Campaign display name."
        },
        "link_set_id": {
            "type": "integer",
            "description": "Existing multi-link link set id. Required on create."
        },
        "subject": {
            "type": "string",
            "description": "Email subject. Required on create. Supports campaign/contact/link placeholders."
        },
        "sender_name": {
            "type": "string",
            "description": "From display name. Defaults to organization name."
        },
        "sender_local_part": {
            "type": "string",
            "description": "From local part before @. Defaults to surveys."
        },
        "sender_domain": {
            "type": "string",
            "description": "Allowed sender domain. Currently dayalogs.com."
        },
        "from": {
            "type": "string",
            "description": "Alias for full from email, for example surveys@dayalogs.com."
        },
        "from_email": {
            "type": "string",
            "description": "Alias for full from email."
        },
        "from_name": {
            "type": "string",
            "description": "Alias for sender_name."
        },
        "email_template": {
            "type": "string",
            "description": "Template selector: base:dayalogs-basic, base:dayalogs-plain or custom:<id>."
        },
        "template": {
            "type": "string",
            "description": "Alias for email_template."
        },
        "email_template_id": {
            "type": "integer",
            "description": "Ready custom email template id. Alias for custom:<id>."
        },
        "template_id": {
            "type": "integer",
            "description": "Alias for email_template_id."
        },
        "email_template_base_key": {
            "type": "string",
            "description": "Base template key. Alias for base:<key>."
        },
        "template_base_key": {
            "type": "string",
            "description": "Alias for email_template_base_key."
        },
        "body_html": {
            "type": "string",
            "description": "Campaign email body HTML. Required on create. Use {{ @link.url }} or Dayalogs will append a link."
        },
        "html": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body": {
            "type": "string",
            "description": "Alias for body_html."
        },
        "body_text": {
            "type": "string",
            "description": "Optional plain-text body override."
        },
        "text": {
            "type": "string",
            "description": "Alias for body_text."
        },
        "disclaimer_html": {
            "type": "string",
            "description": "Optional legal/disclaimer HTML. Falls back to account default."
        },
        "disclaimer": {
            "type": "string",
            "description": "Alias for disclaimer_html."
        },
        "disclaimer_text": {
            "type": "string",
            "description": "Optional plain-text disclaimer override."
        },
        "include_branding": {
            "type": "boolean",
            "description": "Whether the campaign includes account/survey branding."
        },
        "save_account_disclaimer": {
            "type": "boolean",
            "description": "Also save this disclaimer as the account default."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "test_emails": {
            "type": [
                "array",
                "string"
            ],
            "description": "Test recipient emails as an array or comma/newline-separated string.",
            "items": {
                "type": "string"
            }
        },
        "emails": {
            "type": [
                "array",
                "string"
            ],
            "description": "Alias for test_emails."
        },
        "test_email": {
            "type": "string",
            "description": "Single test email alias."
        },
        "email": {
            "type": "string",
            "description": "Single test email alias."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "campaign_id": {
            "type": "integer",
            "description": "Survey campaign id."
        },
        "id": {
            "type": "integer",
            "description": "Alias for campaign_id."
        },
        "scope": {
            "type": "string",
            "enum": [
                "auto",
                "warmup",
                "remaining",
                "failed"
            ],
            "description": "Queue scope. Defaults to auto, which sends warmup first and remaining after warmup is complete."
        }
    },
    "required": [
        "slug",
        "campaign_id"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        }
    },
    "required": [
        "slug"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "name": {
            "type": "string",
            "description": "Review round name."
        },
        "description": {
            "type": "string",
            "description": "Optional reviewer-facing/internal description."
        },
        "visibility": {
            "type": "string",
            "enum": [
                "collaborative",
                "private"
            ],
            "description": "collaborative lets reviewers see each other comments; private limits visibility."
        },
        "review_locale": {
            "type": "string",
            "enum": [
                "ca",
                "es",
                "en"
            ],
            "description": "Reviewer UI language for this round."
        },
        "close_mode": {
            "type": "string",
            "enum": [
                "manual",
                "all_reviewed",
                "date",
                "date_or_all"
            ],
            "description": "How the round should close."
        },
        "closes_at": {
            "type": "string",
            "description": "ISO-8601 date/time required when close_mode is date or date_or_all."
        },
        "participants": {
            "type": "array",
            "description": "Review participants. Invitations are not emailed by this tool; returned review_url values can be sent later through campaigns.",
            "items": {
                "type": "object",
                "properties": {
                    "name": {
                        "type": "string",
                        "description": "Full reviewer name. Alternative to first_name/last_name."
                    },
                    "first_name": {
                        "type": "string",
                        "description": "Reviewer first name."
                    },
                    "last_name": {
                        "type": "string",
                        "description": "Reviewer last name."
                    },
                    "email": {
                        "type": "string",
                        "description": "Reviewer email."
                    },
                    "role": {
                        "type": "string",
                        "enum": [
                            "comment",
                            "decision"
                        ],
                        "description": "Reviewer role. Defaults to comment."
                    }
                },
                "required": [
                    "email"
                ]
            }
        }
    },
    "required": [
        "slug",
        "name",
        "participants"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        },
        "name": {
            "type": "string",
            "description": "Optional new review round name."
        },
        "description": {
            "type": [
                "string",
                "null"
            ],
            "description": "Optional reviewer-facing/internal description."
        },
        "visibility": {
            "type": "string",
            "enum": [
                "collaborative",
                "private"
            ],
            "description": "collaborative lets reviewers see each other comments; private limits visibility."
        },
        "review_locale": {
            "type": "string",
            "enum": [
                "ca",
                "es",
                "en"
            ],
            "description": "Reviewer UI language for this round."
        },
        "close_mode": {
            "type": "string",
            "enum": [
                "manual",
                "all_reviewed",
                "date",
                "date_or_all"
            ],
            "description": "How the round should close."
        },
        "closes_at": {
            "type": [
                "string",
                "null"
            ],
            "description": "ISO-8601 date/time required when close_mode is date or date_or_all."
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        },
        "name": {
            "type": "string",
            "description": "Full reviewer name. Alternative to first_name/last_name."
        },
        "first_name": {
            "type": "string",
            "description": "Reviewer first name."
        },
        "last_name": {
            "type": "string",
            "description": "Reviewer last name."
        },
        "email": {
            "type": "string",
            "description": "Reviewer email."
        },
        "role": {
            "type": "string",
            "enum": [
                "comment",
                "decision"
            ],
            "description": "comment can comment/reply; decision can also decide comments in supported review UIs."
        }
    },
    "required": [
        "slug",
        "round_id",
        "email"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        },
        "body": {
            "type": "string",
            "description": "Comment body text."
        },
        "text": {
            "type": "string",
            "description": "Alias for body."
        },
        "kind": {
            "type": "string",
            "description": "Target kind such as survey, block, question, option or ending."
        },
        "target_kind": {
            "type": "string",
            "description": "Alias for kind."
        },
        "target_id": {
            "type": "string",
            "description": "Target fragment/question/item id."
        },
        "element_id": {
            "type": "string",
            "description": "Alias for target_id."
        },
        "label": {
            "type": "string",
            "description": "Human-readable target label."
        },
        "target_label": {
            "type": "string",
            "description": "Alias for label."
        },
        "parent_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Optional parent comment id to create a reply."
        },
        "author": {
            "type": "object",
            "description": "Optional author object for organization API keys without user context. Ignored for user-authorized OAuth tokens.",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Full reviewer name. Alternative to first_name/last_name."
                },
                "first_name": {
                    "type": "string",
                    "description": "Reviewer first name."
                },
                "last_name": {
                    "type": "string",
                    "description": "Reviewer last name."
                },
                "email": {
                    "type": "string",
                    "description": "Reviewer email."
                },
                "role": {
                    "type": "string",
                    "enum": [
                        "comment",
                        "decision"
                    ],
                    "description": "Reviewer role. Defaults to comment."
                }
            },
            "required": [
                "email"
            ]
        },
        "participant": {
            "type": "object",
            "description": "Alias for author.",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Full reviewer name. Alternative to first_name/last_name."
                },
                "first_name": {
                    "type": "string",
                    "description": "Reviewer first name."
                },
                "last_name": {
                    "type": "string",
                    "description": "Reviewer last name."
                },
                "email": {
                    "type": "string",
                    "description": "Reviewer email."
                },
                "role": {
                    "type": "string",
                    "enum": [
                        "comment",
                        "decision"
                    ],
                    "description": "Reviewer role. Defaults to comment."
                }
            },
            "required": [
                "email"
            ]
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "comment_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review comment id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for comment_id."
        },
        "status": {
            "type": "string",
            "enum": [
                "approved",
                "rejected",
                "resolved",
                "applied"
            ],
            "description": "Decision status to set on the comment."
        },
        "decision": {
            "type": "string",
            "enum": [
                "approved",
                "rejected",
                "resolved",
                "applied"
            ],
            "description": "Alias for status."
        },
        "decision_note": {
            "type": "string",
            "description": "Optional decision note."
        },
        "note": {
            "type": "string",
            "description": "Alias for decision_note."
        },
        "confirm_decision": {
            "type": "boolean",
            "description": "Must be true only after the user explicitly approves this specific review comment decision. Without it, the tool returns confirmation guidance and does not mutate the comment."
        }
    },
    "required": [
        "slug",
        "comment_id",
        "status"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "participant_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review participant id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for participant_id."
        }
    },
    "required": [
        "slug",
        "participant_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {
        "slug": {
            "type": "string",
            "description": "Survey slug."
        },
        "round_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Review round id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for round_id."
        }
    },
    "required": [
        "slug",
        "round_id"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "logo_alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Account default logo alignment."
        },
        "alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Alias for logo_alignment."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "content_base64": {
            "type": "string",
            "description": "Base64 image content. Data URLs are accepted."
        },
        "filename": {
            "type": "string",
            "description": "Original filename for metadata."
        },
        "mime_type": {
            "type": "string",
            "description": "image/png, image/jpeg or image/webp. Optional when content_base64 is a data URL."
        },
        "logo_alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Optional logo alignment to save with the upload."
        },
        "alignment": {
            "type": "string",
            "enum": [
                "left",
                "center",
                "right"
            ],
            "description": "Alias for logo_alignment."
        }
    },
    "required": [
        "content_base64"
    ]
}

{
    "type": "object",
    "properties": {},
    "required": []
}

{
    "type": "object",
    "properties": {
        "include_css": {
            "type": "boolean",
            "description": "Include full CSS in the response. Defaults to false."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "style_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Custom style id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for style_id."
        },
        "include_css": {
            "type": "boolean",
            "description": "Include full CSS. Defaults to true for get_style."
        }
    },
    "required": [
        "style_id"
    ]
}

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Style name."
        },
        "slug": {
            "type": "string",
            "description": "Optional style slug for update."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "ready"
            ],
            "description": "Style status. Ready styles can be assigned to surveys."
        },
        "base_key": {
            "type": "string",
            "description": "Base style key used by generated configs."
        },
        "css": {
            "type": "string",
            "description": "Scoped CSS using only allowed Dayalogs survey selectors."
        },
        "config": {
            "type": "object",
            "description": "Dayalogs style-config JSON object."
        },
        "theme": {
            "type": "object",
            "description": "Alias for config."
        },
        "definition": {
            "type": "object",
            "description": "Alias for config."
        },
        "config_json": {
            "type": "string",
            "description": "Style config encoded as JSON."
        },
        "answers": {
            "type": "object",
            "description": "Generator answer object for quick style generation."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "name": {
            "type": "string",
            "description": "Style name."
        },
        "slug": {
            "type": "string",
            "description": "Optional style slug for update."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "ready"
            ],
            "description": "Style status. Ready styles can be assigned to surveys."
        },
        "base_key": {
            "type": "string",
            "description": "Base style key used by generated configs."
        },
        "css": {
            "type": "string",
            "description": "Scoped CSS using only allowed Dayalogs survey selectors."
        },
        "config": {
            "type": "object",
            "description": "Dayalogs style-config JSON object."
        },
        "theme": {
            "type": "object",
            "description": "Alias for config."
        },
        "definition": {
            "type": "object",
            "description": "Alias for config."
        },
        "config_json": {
            "type": "string",
            "description": "Style config encoded as JSON."
        },
        "answers": {
            "type": "object",
            "description": "Generator answer object for quick style generation."
        }
    },
    "required": []
}

{
    "type": "object",
    "properties": {
        "base_key": {
            "type": "string",
            "description": "Locked base style key to clone."
        },
        "name": {
            "type": "string",
            "description": "Optional new custom style name."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "ready"
            ],
            "description": "Optional initial status. Defaults to draft."
        }
    },
    "required": [
        "base_key"
    ]
}

{
    "type": "object",
    "properties": {
        "style_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Custom style id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for style_id."
        },
        "name": {
            "type": "string",
            "description": "Style name."
        },
        "slug": {
            "type": "string",
            "description": "Optional style slug for update."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "ready"
            ],
            "description": "Style status. Ready styles can be assigned to surveys."
        },
        "base_key": {
            "type": "string",
            "description": "Base style key used by generated configs."
        },
        "css": {
            "type": "string",
            "description": "Scoped CSS using only allowed Dayalogs survey selectors."
        },
        "config": {
            "type": "object",
            "description": "Dayalogs style-config JSON object."
        },
        "theme": {
            "type": "object",
            "description": "Alias for config."
        },
        "definition": {
            "type": "object",
            "description": "Alias for config."
        },
        "config_json": {
            "type": "string",
            "description": "Style config encoded as JSON."
        },
        "answers": {
            "type": "object",
            "description": "Generator answer object for quick style generation."
        }
    },
    "required": [
        "style_id"
    ]
}

{
    "type": "object",
    "properties": {
        "style_id": {
            "type": "integer",
            "minimum": 1,
            "description": "Custom style id."
        },
        "id": {
            "type": "integer",
            "minimum": 1,
            "description": "Alias for style_id."
        },
        "name": {
            "type": "string",
            "description": "Style name."
        },
        "slug": {
            "type": "string",
            "description": "Optional style slug for update."
        },
        "status": {
            "type": "string",
            "enum": [
                "draft",
                "ready"
            ],
            "description": "Style status. Ready styles can be assigned to surveys."
        },
        "base_key": {
            "type": "string",
            "description": "Base style key used by generated configs."
        },
        "css": {
            "type": "string",
            "description": "Scoped CSS using only allowed Dayalogs survey selectors."
        },
        "config": {
            "type": "object",
            "description": "Dayalogs style-config JSON object."
        },
        "theme": {
            "type": "object",
            "description": "Alias for config."
        },
        "definition": {
            "type": "object",
            "description": "Alias for config."
        },
        "config_json": {
            "type": "string",
            "description": "Style config encoded as JSON."
        },
        "answers": {
            "type": "object",
            "description": "Generator answer object for quick style generation."
        }
    },
    "required": [
        "style_id"
    ]
}