Only the fields you send change. proxy adds or removes the proxy link; a proxy link's slug can't change. Turning a feedback session back on needs room in the plan's maxFeedbackSessions, and setting a password a proxy link and a plan with feedbackSessionPassword. Fails with 409 when a new proxy link's slug is taken. Requires feedbackSession:update.
apiKeyAuthorizationBearer <token>An organization API key from the dashboard (Settings → API keys), e.g. Authorization: Bearer annoty_.... x-api-key: annoty_... also works. While the organization has no subscription or trial, every request with a key except GET /v1/organization fails with 402 SUBSCRIPTION_REQUIRED.
feedbackSessionId*stringapplication/jsonlabel?string1 <= length <= 100targetUrl?stringThe site reviewers see, with the comment widget added
urilength <= 2048isActive?booleanfalse turns the proxy link and the embed link off and keeps the comments
expiresAt?|The proxy link and the embed link stop working after this. Null for never.
date-timenotificationsMuted?booleanproxy?booleantrue adds a proxy link, with slug or a random one; it's a no-op when there is one. false removes it with its password: its slug stays with your organization for 60 days, so adding it back in that time can take the same slug. The embed link works either way.
slug?stringThe new proxy link's subdomain, with proxy: true on a feedback session without one. A proxy link's slug can't be changed.
3 <= length <= 63password?|A new password asks every browser for it again. Null removes it, which every plan can do.
6 <= length <= 100The updated feedback session
application/jsonid*stringprojectId*stringlabel*stringdataSession*|Set when the project embed link created this feedback session: the embed script's data-session, or the page's host without one, slugified. The project embed link opens this feedback session again wherever the embed script names it.
slug*|The proxy link's subdomain on annoty.site; null without a proxy link
proxyUrl*|The proxy link: the target site on annoty.site with the comment toolbar on top. Nothing to install on the site. Anyone who has it can read and post comments. Null when the feedback session has none (proxy: false): reviewers open it with embedUrl only.
password*|The proxy link asks for it before it shows the site, once per browser; null when it doesn't, or when there's no proxy link. Members who open the feedback session from the dashboard skip it. The embed link never asks for it. An empty string when it can't be read back: set a new one.
targetUrl*stringembedKey*stringThe embed link's key. Put it in the embed script's data-key to open the toolbar on the target site without a link, for everyone who loads the page: that makes it public on the page. Anyone who has it can read and post comments.
embedUrl*stringThe embed link: the target URL with an embed key in its fragment, which opens the comment toolbar on the site itself. Works once the site loads the embed script (embedScriptUrl), including behind a login. Like proxyUrl, anyone who has it can read and post comments.
embedScriptUrl*stringThe embed script, which the target site loads on every page for embedUrl to work: <script async src="…"></script>. The same for every feedback session.
isActive*booleanexpiresAt*|date-timecommentCount*integerComment threads; replies aren't counted
openCommentCount*integernotificationsMuted*booleanThe project's notification destinations skip this feedback session; its own destinations still get its events
status*stringinactive when isActive is false, expired once expiresAt has passed. Only active feedback sessions open and count toward the plan's maxFeedbackSessions.
"active""inactive""expired"createdAt*stringdate-timecurl -X PATCH 'https://api.annoty.app/v1/feedback-sessions/string' \
-H 'Content-Type: application/json' \
-d '{}'{
"id": "string",
"projectId": "string",
"label": "string",
"dataSession": "string",
"slug": "string",
"proxyUrl": "string",
"password": "string",
"targetUrl": "string",
"embedKey": "string",
"embedUrl": "string",
"embedScriptUrl": "string",
"isActive": true,
"expiresAt": "2019-08-24T14:15:22Z",
"commentCount": 0,
"openCommentCount": 0,
"notificationsMuted": true,
"status": "active",
"createdAt": "2019-08-24T14:15:22Z"
}