POST /api/v1/agents/survey with an agent token carrying survey:write. Optional. Body: agent-survey.
| Field | Required | Notes |
|---|---|---|
current_tools | Yes | Tools the agent uses now |
missing_capabilities | Yes | What it cannot do today |
evidence_required | Yes | What evidence it needs before acting |
payment_authority | Yes | none, within_limits, requires_human_approval or unknown |
payment_limits_note | No | Up to 500 characters |
preferred_formats | Yes | Any of json, markdown, openapi, mcp |
feature_requests | Yes | Up to 4,000 characters |
ranked_priorities | Yes | Most important first |
follow_up_permission | Yes | Whether Dusk State may contact the principal |
consent_version | Yes | As for the waiting list |
Reply and errors
As for the agent waiting list: 201 with id, status, registration_id and trust; a second survey from the same registration gets 409.