HydraCore
API by router

Platform forms internal

List Form Submissions

List submissions for a form. Proxy-key auth.

GET
/internal/v1/instances/{instance_id}/form-submissions

Path Parameters

instance_idInstance Id
Formatuuid

Query Parameters

form_idForm Id
Formatuuid
status?Status
limit?Limit
Default50
Range1 <= value <= 200
offset?Offset
Default0
Range0 <= value

Response Body

curl -X GET "https://loading/internal/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/form-submissions?form_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&status=string&limit=50&offset=0"
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Generate a magic-link token for a form and create a draft submission.

Called by the platform:forms skill when an agent says "onboard Dave". Returns the form URL + token for the agent to send via SMS/WhatsApp.

POST
/internal/v1/instances/{instance_id}/send-form

Path Parameters

instance_idInstance Id
Formatuuid
customer_idCustomer Id
Formatuuid
form_idForm Id
Formatuuid
initiated_via?Initiated Via
Default"agent"
respondent_person_id?Respondent Person Id
ttl_hours?Ttl Hours
Default168
Range1 <= value <= 720

Response Body

curl -X POST "https://loading/internal/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/send-form" \  -H "Content-Type: application/json" \  -d '{    "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e",    "form_id": "46af4ef5-2c18-4098-9bc5-c048fb90b843"  }'
null
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}