Configure recordings
Enable or disable replay and heatmaps, sample rates, duration and blocked selectors. Text and inputs stay strictly masked.
On this page
update_recorder_settingsAccess & permissions
Use POST with an explicitly writable credential. Current membership and the operation's workspace role are still enforced. Review the exact action before executing it.
API keys default to their bound site. For multi-site OAuth connections, call list_projects and pass the intended projectId. Only approved sites are accessible.
Arguments
projectIdOptionalstring · uuid
Weeveo project id. Defaults to the key's project.
Validation pattern: see complete JSON Schema
replayEnabledRequiredboolean
heatmapEnabledRequiredboolean
sampleRateOptionalnumber
Default: 0.15
min 0; max 1
heatmapSampleRateOptionalnumber
Default: 0.15
min 0; max 1
maxDurationOptionalinteger
Default: 300000
min 60000; max 3600000
blockSelectorOptionalstring
Default: ""
max length 500
Nested fields are listed with dotted paths; array item fields use []. Defaults apply to omitted arguments. For unions and all validation details, use the complete schema below.
HTTP request
POST https://weeveo.com/api/v1/tools/update_recorder_settings
Authorization: Bearer <YOUR_CREDENTIAL>
Content-Type: application/json
<JSON_ARGUMENT_OBJECT>Replace the placeholders with your server-side credential and a JSON object satisfying the schema. GET is rejected for writes. Do not retry a change blindly after an uncertain network response. These documentation pages never execute a request.
Complete input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"projectId": {
"description": "Weeveo project id. Defaults to the key's project.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"replayEnabled": {
"type": "boolean"
},
"heatmapEnabled": {
"type": "boolean"
},
"sampleRate": {
"default": 0.15,
"type": "number",
"minimum": 0,
"maximum": 1
},
"heatmapSampleRate": {
"default": 0.15,
"type": "number",
"minimum": 0,
"maximum": 1
},
"maxDuration": {
"default": 300000,
"type": "integer",
"minimum": 60000,
"maximum": 3600000
},
"blockSelector": {
"default": "",
"type": "string",
"maxLength": 500
}
},
"required": [
"replayEnabled",
"heatmapEnabled"
]
}Download all tool schemas or query authenticated GET /api/v1/tools for runtime discovery.
Response & errors
{
"tool": "update_recorder_settings",
"result": "<tool-specific value>"
}The result placeholder above describes the response envelope, not a literal returned string or a universal result schema. Results vary by tool. Fields named Cents are minor currency units; use returned currency labels. Secrets from creation tools are one-time results and must be saved securely immediately.
Failures return an HTTP error status with an error message. See errors, limits and retries, common analytics arguments and permissions.
Still looking for an answer? Try troubleshooting or get in touch.