An app or an AI assistant acts as the person who connected it, so that person’s role applies, and archiving, restoring and copying require the permission to manage surveys. An API key acts for the organization.
Get the share link
- It uses the survey’s custom domain when that domain is live and your plan includes custom domains. Otherwise it uses Usertick’s survey address, and
customDomainstill shows the domain with itsstate:dns,certificate,liveorunreachable. urlisnullwhile link sharing is off. A person turns the link on in Usertick, and the API never changes it.answeringistrueonly while the link is on, the survey is live and Usertick hasn’t taken it offline. A draft, paused or archived survey shows its link without taking answers.languagemust be one of the survey’slanguages, and it adds?lang=to the link so the survey opens in that language. Any other value returns400withPUB-009-001.
qr=svg, qr.svg holds the QR code of url as an SVG document. It is the same file the panel’s Download SVG saves, with the code and, when attribution is true, the “Powered by Usertick” line under it. The line follows the survey’s badge setting and stays on plans that don’t allow hiding the badge. Your own logo isn’t included in the SVG. qr is null while url is null, and any other value of qr returns 400 with PUB-009-002.
Archive and restore a survey
You can archive a survey in draft, live or paused status. The survey stops showing and taking answers at once, leaves the survey list and frees its place in your plan’s survey limit, while its responses stay. Archiving a survey that is already archived returns409 with SRV-010-002.
Restoring brings an archived survey back as a draft, with any edits that waited while it was archived, and never publishes or resumes the survey. A restore:
- takes a place in your plan’s survey limit, and returns
403withPLN-001-002when the plan is full; - returns
409withPUB-008-003while the survey is open in the Usertick editor; send it again once the person closes the editor; - returns
409withSRV-011-002for a survey that isn’t archived.
GET /surveys lists it.
Copy a survey into a draft
- Without a body, or without
name, Usertick names the copy ” copy”, shortening a long name so the copy fits 255 characters. - The copy doesn’t take over the source’s link. A link or email survey’s copy gets its own link, as any new survey does, and takes no answers while it is a draft.
- The copy stays in the source’s folder.
- The copy counts as a new survey, so your plan’s limits refuse it rather than cut it, with
PLN-001-002for surveys,PLN-001-003for questions per survey andSRV-001-027for languages per survey. - Each copy uses one of the credential’s 200 survey creates a day, which it shares with
POST /surveys. Past that allowance, the call returns429withPUB-008-008.
201 with the draft, in the shape GET /surveys/{surveyId}/draft returns, and its address in Location. Give the person editorUrl, which opens the copy in the Usertick editor where they review and publish it. If you send the request again with the same Idempotency-Key, it returns the same copy. See Idempotency.