Send the answered dialog messages back to the institution (ReplyDialog); the answer is either the next dialog step or the completed dialog, after which the result can be fetched

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://restapi.wyzio.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}

POST /api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog/reply

Headers

WEAL-TOKEN Required

API token (can be retrieved from account settings)
TARGET-ORGANIZATION-ID

ID of organization, for which the operation must be performed

Path parameters

jobKey string Required
domainStatusId integer(int64) Required

application/json

Body Required

messages array[object]
Hide messages attributes Show messages attributes object
- storyId string
- standardDialogId string
- creation string(date-time)
- title string
- description string
- sections array[object]
  Hide sections attributes Show sections attributes object
  
  sectionId string
  
  heading string
  
  description string
- paragraphs array[object]
  Hide paragraphs attributes Show paragraphs attributes object
  
  id integer(int32)
  
  label string
  
  sectionIdRef string
  
  valueType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  value string
  
  answerType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  answerDefault string
  
  answerValue string
  
  answerOptional boolean
  
  problem string

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- domainStatusId integer(int64)
- domain string
  
  Values are AHV_AVS, BVG_LPP, UVG_LAA, UVGZ_LAAC, KTG_AMC, FAK_CAF, TAX, TAX_AT_SOURCE, TAX_CROSSBORDER, STATISTIC, or UNEMPLOYMENT_CERTIFICATES.
- institutionIdRef string
- institutionName string
- state string
  
  Values are OPEN, COMPLETED, PROCESSING, ERROR, NOT_SUPPORTED, or FAULT.
- fetchedDate string(date-time)
- expectedAvailability string(date-time)
- endUserInformation string
- detailInformation string
- responseId string
- requestId string
- notifications array[object]
  
  Hide notifications attributes Show notifications attributes object
  
  level string
  
  Values are WARNING or INFO.
  
  qualityLevel string
  
  descriptionCode string
  
  description string
  
  stage string
  
  Values are STATUS, RESULT, or DIALOG.
- messages array[object]
  
  Hide messages attributes Show messages attributes object
  
  storyId string
  
  standardDialogId string
  
  creation string(date-time)
  
  title string
  
  description string
  
  sections array[object]
  
  Hide sections attributes Show sections attributes object
  
  sectionId string
  
  heading string
  
  description string
  
  paragraphs array[object]
  
  Hide paragraphs attributes Show paragraphs attributes object
  
  id integer(int32)
  
  label string
  
  sectionIdRef string
  
  valueType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  value string
  
  answerType string
  
  Values are STRING, INTEGER, DOUBLE, BOOLEAN, DATE, DATE_TIME, YES_NO_UNKNOWN, or AMOUNT.
  
  answerDefault string
  
  answerValue string
  
  answerOptional boolean
  
  problem string
400

400 Bad Request
401

401 Unauthorized
403

403 Access Denied
404

404 Not Found
500

500 Internal Server Error

POST /api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog/reply

curl \
 --request POST 'https://wyzio.app/api-v1/swissdec/salary-declaration/{jobKey}/institutions/{domainStatusId}/dialog/reply' \
 --header "Content-Type: application/json" \
 --data '{"messages":[{"storyId":"string","standardDialogId":"string","creation":"2026-05-04T09:42:00Z","title":"string","description":"string","sections":[{"sectionId":"string","heading":"string","description":"string"}],"paragraphs":[{"id":42,"label":"string","sectionIdRef":"string","valueType":"STRING","value":"string","answerType":"STRING","answerDefault":"string","answerValue":"string","answerOptional":true,"problem":"string"}]}]}'

Request examples

# Headers

# Payload
{
  "messages": [
    {
      "storyId": "string",
      "standardDialogId": "string",
      "creation": "2026-05-04T09:42:00Z",
      "title": "string",
      "description": "string",
      "sections": [
        {
          "sectionId": "string",
          "heading": "string",
          "description": "string"
        }
      ],
      "paragraphs": [
        {
          "id": 42,
          "label": "string",
          "sectionIdRef": "string",
          "valueType": "STRING",
          "value": "string",
          "answerType": "STRING",
          "answerDefault": "string",
          "answerValue": "string",
          "answerOptional": true,
          "problem": "string"
        }
      ]
    }
  ]
}

Response examples (200)

{
  "domainStatusId": 42,
  "domain": "AHV_AVS",
  "institutionIdRef": "string",
  "institutionName": "string",
  "state": "OPEN",
  "fetchedDate": "2026-05-04T09:42:00Z",
  "expectedAvailability": "2026-05-04T09:42:00Z",
  "endUserInformation": "string",
  "detailInformation": "string",
  "responseId": "string",
  "requestId": "string",
  "notifications": [
    {
      "level": "WARNING",
      "qualityLevel": "string",
      "descriptionCode": "string",
      "description": "string",
      "stage": "STATUS"
    }
  ],
  "messages": [
    {
      "storyId": "string",
      "standardDialogId": "string",
      "creation": "2026-05-04T09:42:00Z",
      "title": "string",
      "description": "string",
      "sections": [
        {
          "sectionId": "string",
          "heading": "string",
          "description": "string"
        }
      ],
      "paragraphs": [
        {
          "id": 42,
          "label": "string",
          "sectionIdRef": "string",
          "valueType": "STRING",
          "value": "string",
          "answerType": "STRING",
          "answerDefault": "string",
          "answerValue": "string",
          "answerOptional": true,
          "problem": "string"
        }
      ]
    }
  ]
}