Only the fields you send change. Requires project: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.
projectId*stringapplication/jsonname?string1 <= length <= 100domain?|The site's domain, e.g. example.com. Stored lowercase. Optional; null clears it.
1 <= length <= 253allowedHosts?array<>Up to 3 hosts or patterns, on any site: staging.example.com, or one * in the first label for preview deploys, like *.my-app.pages.dev, *--my-site.netlify.app or my-app-git-*-team.vercel.app. A * matches part of one label only. Stored lowercase; repeats are dropped.
items <= 3screenshotsEnabled?booleanWhether new comments carry a screenshot of what the reviewer saw. Defaults to true.
toolbarPosition?stringThe corner the review toolbar opens in. Defaults to bottom-right.
"top-left""top-right""bottom-left""bottom-right"The updated project
application/jsonid*stringname*stringdomain*string|nullfaviconUrl*|The site's icon, fetched from domain in the background once it's set or changed, and refreshed monthly. Null without a domain, until the icon is found (usually a few seconds after saving), or when the site has none we could fetch.
allowedHosts*array<string>Where the project embed link works besides domain, like staging sites and preview deploys: hosts, or patterns with one * in the first label, matching one or more characters of that label.
embedKey*stringThe project embed link's key. Add #annoty=<embedKey> to the address of any page on domain or allowedHosts to link reviewers to that page, or put it in the embed script's data-key to open the toolbar there without a link, for everyone who loads the page. Anyone who has it can read and post comments on every feedback session it opens, and create new ones. Regenerate it to end every project embed link shared so far, and every data-key with it.
embedUrl*|The project embed link on domain, null without one. On a site that loads the embed script, it opens the feedback session the script's data-session names and creates it on first use; without data-session, the one for the page's host.
embedScriptUrl*stringThe embed script: <script async src="…" data-session="…"></script> on every page of the site.
screenshotsEnabled*booleanWhether new comments carry a screenshot of what the reviewer saw. Turn it off for a site with customer data on screen: widgets stop taking them, on proxy links and embed links alike, from their next comment. Screenshots taken before stay with their comments.
toolbarPosition*stringThe corner the review toolbar opens in, on proxy links and embed links alike: top-left, top-right, bottom-left or bottom-right. A reviewer who moves the toolbar keeps their own corner, and the embed script's data-position overrides this on its site.
"top-left""top-right""bottom-left""bottom-right"createdAt*stringdate-timecurl -X PATCH 'https://api.annoty.app/v1/projects/string' \
-H 'Content-Type: application/json' \
-d '{}'{
"id": "string",
"name": "string",
"domain": "string",
"faviconUrl": "string",
"allowedHosts": [
"string"
],
"embedKey": "string",
"embedUrl": "string",
"embedScriptUrl": "string",
"screenshotsEnabled": true,
"toolbarPosition": "top-left",
"createdAt": "2019-08-24T14:15:22Z"
}