Engagement Survey

Migrate a legacy survey

Convert a legacy survey to Surveys 2.0 (published as version 1) and move its answer tickets into survey responses. Idempotent. Up to 1000 tickets move in the request; the rest continue in the background. Returns the outbound (with survey) and migration: { status: 'done'|'running', responses?, warnings? }; 422 { errors } when the legacy form cannot be converted.

POST

https://api.gleap.io/v3/engagement/surveys/{surveyId}/migrate

Authorizations

Authorizationstring · headerrequired

Bearer authentication header of the form Bearer <token>.

Path parameters

surveyIdstringrequired

Headers

projectstringrequired

Response

application/json

Updated November 1, 2026

curl --request POST \
  --url 'https://api.gleap.io/v3/engagement/surveys/{surveyId}/migrate' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'

No example in the spec.