Create or update a Swissdec institution reference

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

mcp.json 
{
  "Wyzio MCP server": {
    "url": "https://restapi.wyzio.com/mcp"
  }
}
Close
POST /api-v1/swissdec/institutions

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

application/json

Body Required

  • id integer(int64)
  • organizationId 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.

  • organizationEmployeeGroupId integer(int64)
  • institutionKey string
  • name string
  • institutionId string
  • customerIdentity string
  • contractIdentity string
  • active boolean

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • id integer(int64)
    • organizationId 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.

    • organizationEmployeeGroupId integer(int64)
    • institutionKey string
    • name string
    • institutionId string
    • customerIdentity string
    • contractIdentity string
    • active boolean
  • 400

    400 Bad Request

  • 401

    401 Unauthorized

  • 403

    403 Access Denied

  • 404

    404 Not Found

  • 500

    500 Internal Server Error

POST /api-v1/swissdec/institutions 
curl \
 --request POST 'https://wyzio.app/api-v1/swissdec/institutions' \
 --header "Content-Type: application/json" \
 --data '{"id":42,"organizationId":42,"domain":"AHV_AVS","organizationEmployeeGroupId":42,"institutionKey":"string","name":"string","institutionId":"string","customerIdentity":"string","contractIdentity":"string","active":true}'
Request examples 
# Headers

# Payload
{
  "id": 42,
  "organizationId": 42,
  "domain": "AHV_AVS",
  "organizationEmployeeGroupId": 42,
  "institutionKey": "string",
  "name": "string",
  "institutionId": "string",
  "customerIdentity": "string",
  "contractIdentity": "string",
  "active": true
}
Response examples (200) 
{
  "id": 42,
  "organizationId": 42,
  "domain": "AHV_AVS",
  "organizationEmployeeGroupId": 42,
  "institutionKey": "string",
  "name": "string",
  "institutionId": "string",
  "customerIdentity": "string",
  "contractIdentity": "string",
  "active": true
}