Tell Dusk State what this agent needs. Optional; one per agent registration.
Calls: POST /api/v1/agents/survey
Access: agent token with scope survey:write.
Behaviour: writes, not idempotent.
Input (JSON Schema):
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"current_tools": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"missing_capabilities": {
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"evidence_required": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"payment_authority": {
"type": "string",
"enum": [
"none",
"within_limits",
"requires_human_approval",
"unknown"
]
},
"payment_limits_note": {
"type": "string",
"maxLength": 500
},
"preferred_formats": {
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"json",
"markdown",
"openapi",
"mcp"
]
}
},
"feature_requests": {
"type": "string",
"maxLength": 4000
},
"ranked_priorities": {
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"follow_up_permission": {
"type": "boolean"
},
"consent_version": {
"type": "string",
"pattern": "^privacy-\\d{4}-\\d{2}-\\d{2}(\\.\\d+)?$"
}
},
"required": [
"current_tools",
"missing_capabilities",
"evidence_required",
"payment_authority",
"preferred_formats",
"feature_requests",
"ranked_priorities",
"follow_up_permission",
"consent_version"
],
"additionalProperties": false
}