form:fill

Description: Fill a form by ID.

---

Request Schema

{
  "payload": {
    "id": 1,
    "subject": {
      "type": "person", // or "household"
      "id": 1
    },
    "type": "form:fill",
    "data": { "key1": "value1", ... } // See form:query, for a collection of allowed inputs.keys
  },
  "signature": "payload_ed25519_hex_signature",
  "source_public_key": "your_client_public_key"
}

Request Attributes

• See global request attributes
• payload.id - Integer - The form’s ID in the remote Arkipel community - Compulsory
• payload.subject - Object{type (Enum), id (Integer)} - The form’s subject, please check people:upsert or households:upsert - Compulsory (except when use in contextualized mutation messages like households:upsert, people:upsert or distributions:upsert)
• payload.data - Object - The form’s responses for the given subject as an Hash of keys (see form:query) and values

Response Schema

{
  "source_public_key": "community_public_key",
  "source_site": {
    "protocol": "http",
    "fqdn": "arkipel.localhost:3000"
  },
  "created_at": "2025-11-13T20:52:49Z",
  "signature": "8b6392d5550605bd6ccddf9c21ebec470de4b44e4b4deb746076e37ab61c5346e07e7c7c7cebb5bbee41cdd92a476bcd3f02373d146ec165b31c31fc31c9ce0d",
  "payload": {
    "message_id": "6916452112f746b2b4cf48c1",
    "type": "form:fill"
  }
}