The display mode for the achievement. Useful to make the distinction between normal user achievments and achievments designed for implementing custom app functionality.
The display mode for the achievement. Useful to make the distinction between normal user achievments and achievments designed for implementing custom app functionality.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nudj Platform Documentation","colors":{"primary":"#8082A6","light":"#AFA9D9","dark":"#BDB7E4"},"logo":{"light":"https://mintcdn.com/nudj/Fh-MK3NeO4rWK1Z6/logo/nudj-logo.png?fit=max\u0026auto=format\u0026n=Fh-MK3NeO4rWK1Z6\u0026q=85\u0026s=7340cd62c3a41730e5ce025fd75c842b","dark":"https://mintcdn.com/nudj/Fh-MK3NeO4rWK1Z6/logo/nudj-dark-logo.png?fit=max\u0026auto=format\u0026n=Fh-MK3NeO4rWK1Z6\u0026q=85\u0026s=8cabc0966dfccab00fad982bcf3b465f"},"favicon":"https://mintcdn.com/nudj/Fh-MK3NeO4rWK1Z6/favicon.ico?fit=max\u0026auto=format\u0026n=Fh-MK3NeO4rWK1Z6\u0026q=85\u0026s=7426330b653f33c458339d01295a6965","api":{"playground":{"display":"interactive"}},"appearance":{"default":"light"},"background":{"color":{"light":"#F5F3FB","dark":"#0F1119"}},"navbar":{"links":[{"href":"mailto:support@nudj.cx","label":"Support"}],"primary":{"type":"button","label":"Get API Tokens","href":"https://admin.nudj.cx/admin/settings/organisation?tab=developer"}},"footer":{"socials":{"x":"https://x.com/nudj","github":"https://github.com/nudj-digital","linkedin":"https://www.linkedin.com/company/nudj"}},"fonts":{"heading":{"family":"Playfair Display","weight":700},"body":{"family":"Outfit","weight":400}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nudj","hasAudioNarration":false,"actualSubdomain":"nudj","customDomains":["docs.nudj.cx"],"gitSource":{"type":"github","owner":"nudj-digital","repo":"monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae2174a83326b7b15ea3131","collectionId":"0f9591e5-8c10-41aa-a451-0a3b520f8055","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2174a83326b7b15ea3131"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae2174a83326b7b15ea3131","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Admin API","count":235},{"language":"default","tag":"Control Room","count":93},{"language":"default","tag":"Integration API","count":87},{"language":"default","tag":"Analytics API","count":54},{"language":"default","tag":"User Guide","count":41},{"language":"default","tag":"Ways to Engage","count":39},{"language":"default","tag":"Challenges","count":39},{"language":"default","tag":"Rewards","count":30},{"language":"default","tag":"Organization Settings","count":26},{"language":"default","tag":"Developer","count":25}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#content-area a.link{color:#5f6193;text-decoration-color:#5f6193}#content-area a.link:focus-visible,#content-area a.link:hover{color:#4a4c79;text-decoration-color:#4a4c79}.dark #content-area a.link{color:#bdb7e4;text-decoration-color:#bdb7e4}.dark #content-area a.link:focus-visible,.dark #content-area a.link:hover{color:#d4cfee;text-decoration-color:#d4cfee}"}],"page":{"pagePath":"api-reference/admin/post-achievements","slug":"/api-reference/admin/post-achievements","pageMetadata":{"title":"Create a new achievement","openapi":"openapi/admin.json POST /achievements","description":"Create a new achievement.","href":"/api-reference/admin/post-achievements"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a new achievement.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a new achievement","openapi":"openapi/admin.json POST /achievements","description":"Create a new achievement.","href":"/api-reference/admin/post-achievements"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/nudj/a4881203b9b8dc75/generate-api-docs.js","/_mintlify/custom/nudj/90666c9eadd6f6ca/update-navigation.js","/_mintlify/custom/nudj/cb82a77682afa872/fetch-openapi.js","/_mintlify/custom/nudj/17b922120d4f8afe/fix-navigation.js","/_mintlify/custom/nudj/e3afd7dfb92e6b1b/normalize-openapi.js","/_mintlify/custom/nudj/3e9096727cf1ed8d/restore-general-docs.js","/_mintlify/custom/nudj/05ef9ce7c833cf9b/scripts/generate-all-releases.js","/_mintlify/custom/nudj/e04dda1835326c9c/scripts/sync-highlights-nav.js","/_mintlify/custom/nudj/0a7a1d9fd5d964ad/scripts/sync-releases-nav.js"],"openApiReferenceData":{"operation":{"operationId":"createAchievement","summary":"Create a new achievement","description":"Create a new achievement.","tags":["Achievement"],"requestBody":"d657034f-b5a5-4e02-905d-a51ac8f4982d","responses":{"200":"e10dcbb7-5cb1-4192-8eb1-df7439016e60","400":"b1f00d1a-e73d-4a89-a44f-256a013cceae","500":"267f254a-34ca-4a34-b03b-5d93225e0f7b"},"method":"post","type":"path","servers":["a3578f1c-2881-4c69-bd19-b47edca235fe"],"security":["0d04aee5-14a8-4cbe-bdea-886653c3f242"],"path":"/achievements","baseUrlOptions":["https://{subdomain}.nudj.cx/api/v2/admin"],"title":"Create a new achievement","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"details":{"type":"object","properties":{"title":{"type":"string","description":"The title of the entity","isRequired":true,"uniqueKey":"details.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"The description of the entity","uniqueKey":"details.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The description of the entity","uniqueKey":"details.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.description","typeLabel":"string | null"},"light":{"type":"object","properties":{"primaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the primary image for this theme mode","uniqueKey":"details.light.primaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the primary image for this theme mode","uniqueKey":"details.light.primaryImageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.light.primaryImageUrl","typeLabel":"string | null"},"secondaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the secondary image for this theme mode","uniqueKey":"details.light.secondaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the secondary image for this theme mode","uniqueKey":"details.light.secondaryImageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.light.secondaryImageUrl","typeLabel":"string | null"}},"description":"Light theme images","uniqueKey":"details.light","typeLabel":"object"},"dark":{"type":"object","properties":{"primaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the primary image for this theme mode","uniqueKey":"details.dark.primaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the primary image for this theme mode","uniqueKey":"details.dark.primaryImageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.dark.primaryImageUrl","typeLabel":"string | null"},"secondaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the secondary image for this theme mode","uniqueKey":"details.dark.secondaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the secondary image for this theme mode","uniqueKey":"details.dark.secondaryImageUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.dark.secondaryImageUrl","typeLabel":"string | null"}},"description":"Dark theme images","uniqueKey":"details.dark","typeLabel":"object"}},"required":["title"],"description":"Input for creating entity details with required title","title":"Details Create Input","isRequired":true,"uniqueKey":"details","typeLabel":"Details Create Input · object"},"communityId":{"oneOf":[{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the community this achievement belongs to","uniqueKey":"communityId.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the community this achievement belongs to","uniqueKey":"communityId.oneOf.1","typeLabel":"null"}],"uniqueKey":"communityId","typeLabel":"string | null"},"status":{"type":"string","enum":["archived","draft","expired","live","scheduled"],"description":"Set the achievement status, by default will be set to draft if not provided","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"progressPeriod":{"type":"string","enum":["daily","weekly","monthly","yearly","open"],"description":"The period over which progress is tracked/reset","uniqueKey":"progressPeriod","typeLabel":"enum\u003cstring>"},"criteria":{"oneOf":[{"type":"object","title":"Sum Condition Node","description":"Node that sums values from a specific event attribute and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"sum","description":"Identifies this node as a SumNode type, which is responsible for summing numeric attributes from events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.0.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be included in the sum. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the summed value against the threshold value. For example, 'GreaterThan' would check if the sum exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.operator","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","minLength":1,"description":"The specific event attribute whose values should be summed. This must be a numeric attribute present in the matched events.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.attribute","typeLabel":"string"},"value":{"type":"number","description":"The threshold value to compare the sum against. This represents the target number that the summed values will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.value","typeLabel":"number"}},"required":["query","operator","attribute","value"],"description":"Parameters for a sum condition node that define the attribute summation logic and threshold comparison","title":"Sum Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters","typeLabel":"Sum Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.0","typeLabel":"Sum Condition Node · object"},{"type":"object","title":"Count Condition Node","description":"Node that counts matching events and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"count","description":"Identifies this node as a CountNode type, which is responsible for counting occurrences of events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.1.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be counted. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the counted events against the threshold value. For example, 'GreaterThan' would check if the count exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"number","description":"The threshold value to compare the count against. This represents the target number that the counted events will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.value","typeLabel":"number"}},"required":["query","operator","value"],"description":"Parameters for a count condition node that define the counting logic and threshold comparison","title":"Count Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters","typeLabel":"Count Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.1","typeLabel":"Count Condition Node · object"},{"type":"object","title":"Logical Condition Node","description":"Node that combines multiple conditions with a logical operator to form complex achievement criteria","required":["type","parameters"],"properties":{"type":{"type":"string","const":"logical","description":"Identifies this node as a LogicalNode type, which combines multiple conditions using logical operators","isRequired":true,"uniqueKey":"criteria.oneOf.2.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"operator":{"type":"string","enum":["and","or"],"description":"The logical operator to apply to the conditions. AND requires all conditions to be true, OR requires at least one condition to be true.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","title":"Sum Condition Node","description":"Node that sums values from a specific event attribute and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"sum","description":"Identifies this node as a SumNode type, which is responsible for summing numeric attributes from events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be included in the sum. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the summed value against the threshold value. For example, 'GreaterThan' would check if the sum exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.operator","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","minLength":1,"description":"The specific event attribute whose values should be summed. This must be a numeric attribute present in the matched events.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.attribute","typeLabel":"string"},"value":{"type":"number","description":"The threshold value to compare the sum against. This represents the target number that the summed values will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.value","typeLabel":"number"}},"required":["query","operator","attribute","value"],"description":"Parameters for a sum condition node that define the attribute summation logic and threshold comparison","title":"Sum Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters","typeLabel":"Sum Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0","typeLabel":"Sum Condition Node · object"},{"type":"object","title":"Count Condition Node","description":"Node that counts matching events and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"count","description":"Identifies this node as a CountNode type, which is responsible for counting occurrences of events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be counted. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the counted events against the threshold value. For example, 'GreaterThan' would check if the count exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"number","description":"The threshold value to compare the count against. This represents the target number that the counted events will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.value","typeLabel":"number"}},"required":["query","operator","value"],"description":"Parameters for a count condition node that define the counting logic and threshold comparison","title":"Count Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters","typeLabel":"Count Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1","typeLabel":"Count Condition Node · object"},{}],"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX]","typeLabel":"Sum Condition Node · object | Count Condition Node · object"},"description":"Array of condition nodes to be combined using the logical operator. Can include other logical nodes for nested conditions.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions","typeLabel":"(Sum Condition Node · object | Count Condition Node · object)[]"}},"required":["operator","conditions"],"description":"Parameters for a logical condition node that define how multiple conditions should be combined","title":"Logical Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters","typeLabel":"Logical Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.2","typeLabel":"Logical Condition Node · object"}],"uniqueKey":"criteria","typeLabel":"Sum Condition Node · object | Count Condition Node · object | Logical Condition Node · object"},"displayMode":{"type":"string","enum":["default","custom"],"description":"The display mode for the achievement. Useful to make the distinction between normal user achievments and achievments designed for implementing custom app functionality.","uniqueKey":"displayMode","typeLabel":"enum\u003cstring>"},"queries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"event","description":"Identifies this node as an EventQueryNode type, which defines criteria for selecting events to be evaluated","isRequired":true,"uniqueKey":"queries.items.[INDEX].type","typeLabel":"string"},"alias":{"type":"string","description":"A unique identifier for this query that can be referenced by condition nodes. This allows the same event query to be reused across multiple conditions.","isRequired":true,"uniqueKey":"queries.items.[INDEX].alias","typeLabel":"string"},"parameters":{"type":"object","properties":{"eventName":{"type":"string","description":"The specific name of the event to match. This identifies the type of event that should be included in the achievement progress. When using a custom event, this should be the name of the event. When using a non-custom event, this should be the name of the event category and sub-category concatenated with an underscore.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventName","typeLabel":"string"},"eventCategory":{"type":"string","enum":["achievement","action","auth","blog","challenge","community","custom","game","leaderboard","organisation","points","post","referral","reward","shop","social","social-connection","streak","user","variable","xp"],"description":"The category of events to match. This helps filter events by their broad classification within the system.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventCategory","typeLabel":"enum\u003cstring>"},"eventSubCategory":{"type":"string","enum":["achievement-completion","facebook-comment","facebook-follow","facebook-like","image-analysis-object-detection","image-analysis-receipt-detection","instagram-follow","instagram-like","instagram-comment","instagram-share","instagram-post","interaction-engage-with-content","interaction-external-link","interaction-image-upload","interaction-spot-object","platform-comment-on-post","platform-complete-achievement","platform-generative-action","platform-like-post","platform-play-game","platform-validate-event","question-multiple-choice","question-open-ended","question-rate-your-experience","question-secret-access-code","question-select-date","question-select-from-images","question-select-value-in-range","question-select-from-list","question-closed-ended","question-vote","spotify-follow","spotify-listen","spotify-save","tiktok-follow","tiktok-watch","tiktok-post","youtube-like","youtube-comment","youtube-subscribe","action-completion","skip-action","42-school","api-auth-link","api-token-link","apple","asgardeo","atlassian","auth0","authentik","azure-ad-b2c","azure-ad","azure-devops","battlenet","beyondidentity","box","boxyhq-saml","bungie","click-up","cognito","coinbase","descope","discord","dribbble","dropbox","duende-identity-server6","email","eveonline","facebook","faceit","foursquare","freshbooks","fusionauth","github","gitlab","google","hubspot","identity-server4","instagram","kakao","keycloak","line","linkedin","mailchimp","mailru","mastodon","mattermost","medium","naver","netlify","notion","okta","onelogin","organisation-oidc","osso","osu","passage","patreon","pinterest","pipedrive","reddit","salesforce","slack","spotify","strava","tiktok","todoist","trakt","twitch","twitter","united-effects","vk","wikimedia","wordpress","workos","yandex","youtube","zitadel","zoho","zoom","blog-comment","blog-like","blog-share","blog-view","challenge-started","challenge-completion","challenge-unlock","community-visit","parental-approval-requested","parental-approval-approved","parental-approval-rejected","custom","game-started","game-completed","leaderboard-finish","invite-admin-user","points-credit","points-spend","post-comment","post-like","post-view","reward-redemption","reward-allocation-purchase","reward-giveaway-winner","reward-claim","reward-distribution","manual-distribution","referral-link-used","shop-purchase","share-challenge-details","share-challenge-results","share-community","share-reward","share-post","share-profile","share-anything","streak-extended","profile-picture-added","bio-added","variable-captured","xp-gained","xp-total","xp-leaderboard-topper"],"description":"The sub-category of events to match. This provides more granular filtering within the selected event category.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventSubCategory","typeLabel":"enum\u003cstring>"},"eventSourceId":{"oneOf":[{"type":"string","description":"Optional identifier for the source of the events. When specified, only events from this source will count towards the achievement progress. For example, a challengeId, or another achievementId","uniqueKey":"queries.items.[INDEX].parameters.eventSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional identifier for the source of the events. When specified, only events from this source will count towards the achievement progress. For example, a challengeId, or another achievementId","uniqueKey":"queries.items.[INDEX].parameters.eventSourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].parameters.eventSourceId","typeLabel":"string | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Optional array of tag ids to filter events by. Only events with all specified tags will count towards the achievement progress.","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$"},"description":"Optional array of tag ids to filter events by. Only events with all specified tags will count towards the achievement progress.","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].parameters.tags","typeLabel":"string[] | null"}},"required":["eventName","eventCategory","eventSubCategory"],"description":"Parameters that define the criteria for matching and filtering events","title":"Event Query Node Parameters","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters","typeLabel":"Event Query Node Parameters · object"},"isCommunityScoped":{"oneOf":[{"type":"boolean","default":true,"description":"Controls whether the query should only match events within the achievement's community context. When true (default), only community-specific events are included.","uniqueKey":"queries.items.[INDEX].isCommunityScoped.oneOf.0","typeLabel":"boolean"},{"type":"null","default":true,"description":"Controls whether the query should only match events within the achievement's community context. When true (default), only community-specific events are included.","uniqueKey":"queries.items.[INDEX].isCommunityScoped.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].isCommunityScoped","typeLabel":"boolean | null"}},"required":["type","alias","parameters"],"description":"Node that defines a reusable query for filtering and selecting events to be evaluated by condition nodes","title":"Event Query Node","uniqueKey":"queries.items.[INDEX]","typeLabel":"Event Query Node · object"},"description":"The event queries used to measure progress against this achievement's criteria","uniqueKey":"queries","typeLabel":"Event Query Node · object[]"},"queryDescriptions":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"queryDescriptions.additionalProperties","typeLabel":"string"},"description":"A map of query alias to user-readable descriptions, useful for displaying in the UI. Can be localised across additional languages.","uniqueKey":"queryDescriptions","typeLabel":"object"},"tags":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"The ids of the tags on the achievement","uniqueKey":"tags","typeLabel":"string[]"},"campaigns":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"campaigns.items.[INDEX]","typeLabel":"string"},"description":"The ids of the campaigns on the achievement","uniqueKey":"campaigns","typeLabel":"string[]"},"startsAt":{"oneOf":[{"type":"string","description":"When this achievement becomes available to the user","uniqueKey":"startsAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this achievement becomes available to the user","uniqueKey":"startsAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"startsAt","typeLabel":"string | null"},"expiresAt":{"oneOf":[{"type":"string","description":"When this achievement expires","uniqueKey":"expiresAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this achievement expires","uniqueKey":"expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"expiresAt","typeLabel":"string | null"},"featured":{"oneOf":[{"type":"boolean","description":"Whether the achievement is featured","uniqueKey":"featured.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the achievement is featured","uniqueKey":"featured.oneOf.1","typeLabel":"null"}],"uniqueKey":"featured","typeLabel":"boolean | null"},"isGlobalTemplate":{"type":"boolean","description":"Whether the achievement is a global template","uniqueKey":"isGlobalTemplate","typeLabel":"boolean"},"availableAsTemplateForOrganisations":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"availableAsTemplateForOrganisations.items.[INDEX]","typeLabel":"string"},"description":"The organisations that the achievement is available as a template for","uniqueKey":"availableAsTemplateForOrganisations","typeLabel":"string[]"}},"required":["details"],"description":"The input required to create an achievement","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"details":{"title":"\u003cstring>","description":"\u003cstring>","light":{"primaryImageUrl":"\u003cstring>","secondaryImageUrl":"\u003cstring>"},"dark":{"primaryImageUrl":"\u003cstring>","secondaryImageUrl":"\u003cstring>"}},"communityId":"\u003cstring>","criteria":{"type":"sum","parameters":{"query":"\u003cstring>","attribute":"\u003cstring>","value":123}},"queries":[{"type":"event","alias":"\u003cstring>","parameters":{"eventName":"\u003cstring>","eventSourceId":"\u003cstring>","tags":["\u003cstring>"]},"isCommunityScoped":true}],"queryDescriptions":{},"tags":["\u003cstring>"],"campaigns":["\u003cstring>"],"startsAt":"\u003cstring>","expiresAt":"\u003cstring>","featured":true,"isGlobalTemplate":true,"availableAsTemplateForOrganisations":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e10dcbb7-5cb1-4192-8eb1-df7439016e60":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the achievement","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"organisationId":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the organisation this achievement belongs to","isRequired":true,"uniqueKey":"organisationId","typeLabel":"string"},"details":{"type":"object","properties":{"title":{"type":"string","description":"The title of the entity","isRequired":true,"uniqueKey":"details.title","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"The description of the entity","isRequired":true,"uniqueKey":"details.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The description of the entity","isRequired":true,"uniqueKey":"details.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.description","typeLabel":"string | null"},"light":{"type":"object","properties":{"primaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the primary image for this theme mode","isRequired":true,"uniqueKey":"details.light.primaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the primary image for this theme mode","isRequired":true,"uniqueKey":"details.light.primaryImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.light.primaryImageUrl","typeLabel":"string | null"},"secondaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the secondary image for this theme mode","isRequired":true,"uniqueKey":"details.light.secondaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the secondary image for this theme mode","isRequired":true,"uniqueKey":"details.light.secondaryImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.light.secondaryImageUrl","typeLabel":"string | null"}},"required":["primaryImageUrl","secondaryImageUrl"],"description":"Light theme images","isRequired":true,"uniqueKey":"details.light","typeLabel":"object"},"dark":{"type":"object","properties":{"primaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the primary image for this theme mode","isRequired":true,"uniqueKey":"details.dark.primaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the primary image for this theme mode","isRequired":true,"uniqueKey":"details.dark.primaryImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.dark.primaryImageUrl","typeLabel":"string | null"},"secondaryImageUrl":{"oneOf":[{"type":"string","description":"The url of the secondary image for this theme mode","isRequired":true,"uniqueKey":"details.dark.secondaryImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url of the secondary image for this theme mode","isRequired":true,"uniqueKey":"details.dark.secondaryImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"details.dark.secondaryImageUrl","typeLabel":"string | null"}},"required":["primaryImageUrl","secondaryImageUrl"],"description":"Dark theme images","isRequired":true,"uniqueKey":"details.dark","typeLabel":"object"}},"required":["title","description","light","dark"],"description":"Used to describe an entity","title":"Details","isRequired":true,"uniqueKey":"details","typeLabel":"Details · object"},"progressPeriod":{"type":"string","enum":["daily","weekly","monthly","yearly","open"],"description":"The period over which progress is tracked/reset","isRequired":true,"uniqueKey":"progressPeriod","typeLabel":"enum\u003cstring>"},"displayMode":{"type":"string","enum":["default","custom"],"description":"The display mode for the achievement. Useful to make the distinction between normal user achievments and achievments designed for implementing custom app functionality.","isRequired":true,"uniqueKey":"displayMode","typeLabel":"enum\u003cstring>"},"tags":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"The ids of the tags on the achievement","isRequired":true,"uniqueKey":"tags","typeLabel":"string[]"},"campaigns":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"campaigns.items.[INDEX]","typeLabel":"string"},"description":"The ids of the campaigns on the achievement","isRequired":true,"uniqueKey":"campaigns","typeLabel":"string[]"},"criteria":{"oneOf":[{"type":"object","title":"Sum Condition Node","description":"Node that sums values from a specific event attribute and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"sum","description":"Identifies this node as a SumNode type, which is responsible for summing numeric attributes from events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.0.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be included in the sum. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the summed value against the threshold value. For example, 'GreaterThan' would check if the sum exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.operator","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","minLength":1,"description":"The specific event attribute whose values should be summed. This must be a numeric attribute present in the matched events.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.attribute","typeLabel":"string"},"value":{"type":"number","description":"The threshold value to compare the sum against. This represents the target number that the summed values will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters.value","typeLabel":"number"}},"required":["query","operator","attribute","value"],"description":"Parameters for a sum condition node that define the attribute summation logic and threshold comparison","title":"Sum Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.0.parameters","typeLabel":"Sum Condition Node Parameters · object"}},"isRequired":true,"uniqueKey":"criteria.oneOf.0","typeLabel":"Sum Condition Node · object"},{"type":"object","title":"Count Condition Node","description":"Node that counts matching events and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"count","description":"Identifies this node as a CountNode type, which is responsible for counting occurrences of events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.1.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be counted. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the counted events against the threshold value. For example, 'GreaterThan' would check if the count exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"number","description":"The threshold value to compare the count against. This represents the target number that the counted events will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters.value","typeLabel":"number"}},"required":["query","operator","value"],"description":"Parameters for a count condition node that define the counting logic and threshold comparison","title":"Count Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.1.parameters","typeLabel":"Count Condition Node Parameters · object"}},"isRequired":true,"uniqueKey":"criteria.oneOf.1","typeLabel":"Count Condition Node · object"},{"type":"object","title":"Logical Condition Node","description":"Node that combines multiple conditions with a logical operator to form complex achievement criteria","required":["type","parameters"],"properties":{"type":{"type":"string","const":"logical","description":"Identifies this node as a LogicalNode type, which combines multiple conditions using logical operators","isRequired":true,"uniqueKey":"criteria.oneOf.2.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"operator":{"type":"string","enum":["and","or"],"description":"The logical operator to apply to the conditions. AND requires all conditions to be true, OR requires at least one condition to be true.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.operator","typeLabel":"enum\u003cstring>"},"conditions":{"type":"array","items":{"oneOf":[{"type":"object","title":"Sum Condition Node","description":"Node that sums values from a specific event attribute and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"sum","description":"Identifies this node as a SumNode type, which is responsible for summing numeric attributes from events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be included in the sum. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the summed value against the threshold value. For example, 'GreaterThan' would check if the sum exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.operator","typeLabel":"enum\u003cstring>"},"attribute":{"type":"string","minLength":1,"description":"The specific event attribute whose values should be summed. This must be a numeric attribute present in the matched events.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.attribute","typeLabel":"string"},"value":{"type":"number","description":"The threshold value to compare the sum against. This represents the target number that the summed values will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters.value","typeLabel":"number"}},"required":["query","operator","attribute","value"],"description":"Parameters for a sum condition node that define the attribute summation logic and threshold comparison","title":"Sum Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0.parameters","typeLabel":"Sum Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.0","typeLabel":"Sum Condition Node · object"},{"type":"object","title":"Count Condition Node","description":"Node that counts matching events and compares against a threshold","required":["type","parameters"],"properties":{"type":{"type":"string","const":"count","description":"Identifies this node as a CountNode type, which is responsible for counting occurrences of events and comparing against a threshold","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.type","typeLabel":"string"},"parameters":{"type":"object","properties":{"query":{"type":"string","description":"Reference to the query alias that identifies which events should be counted. This query must be defined in an EventQueryNode within the achievement's criteria array.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.query","typeLabel":"string"},"operator":{"type":"string","enum":["==","!=",">","\u003c",">=","\u003c="],"description":"Comparison operator that defines how to compare the counted events against the threshold value. For example, 'GreaterThan' would check if the count exceeds the threshold.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.operator","typeLabel":"enum\u003cstring>"},"value":{"type":"number","description":"The threshold value to compare the count against. This represents the target number that the counted events will be compared to using the specified operator.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters.value","typeLabel":"number"}},"required":["query","operator","value"],"description":"Parameters for a count condition node that define the counting logic and threshold comparison","title":"Count Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1.parameters","typeLabel":"Count Condition Node Parameters · object"}},"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX].oneOf.1","typeLabel":"Count Condition Node · object"},{}],"uniqueKey":"criteria.oneOf.2.parameters.conditions.items.[INDEX]","typeLabel":"Sum Condition Node · object | Count Condition Node · object"},"description":"Array of condition nodes to be combined using the logical operator. Can include other logical nodes for nested conditions.","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters.conditions","typeLabel":"(Sum Condition Node · object | Count Condition Node · object)[]"}},"required":["operator","conditions"],"description":"Parameters for a logical condition node that define how multiple conditions should be combined","title":"Logical Condition Node Parameters","isRequired":true,"uniqueKey":"criteria.oneOf.2.parameters","typeLabel":"Logical Condition Node Parameters · object"}},"isRequired":true,"uniqueKey":"criteria.oneOf.2","typeLabel":"Logical Condition Node · object"}],"isRequired":true,"uniqueKey":"criteria","typeLabel":"Sum Condition Node · object | Count Condition Node · object | Logical Condition Node · object"},"queries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"event","description":"Identifies this node as an EventQueryNode type, which defines criteria for selecting events to be evaluated","isRequired":true,"uniqueKey":"queries.items.[INDEX].type","typeLabel":"string"},"alias":{"type":"string","description":"A unique identifier for this query that can be referenced by condition nodes. This allows the same event query to be reused across multiple conditions.","isRequired":true,"uniqueKey":"queries.items.[INDEX].alias","typeLabel":"string"},"parameters":{"type":"object","properties":{"eventName":{"type":"string","description":"The specific name of the event to match. This identifies the type of event that should be included in the achievement progress. When using a custom event, this should be the name of the event. When using a non-custom event, this should be the name of the event category and sub-category concatenated with an underscore.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventName","typeLabel":"string"},"eventCategory":{"type":"string","enum":["achievement","action","auth","blog","challenge","community","custom","game","leaderboard","organisation","points","post","referral","reward","shop","social","social-connection","streak","user","variable","xp"],"description":"The category of events to match. This helps filter events by their broad classification within the system.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventCategory","typeLabel":"enum\u003cstring>"},"eventSubCategory":{"type":"string","enum":["achievement-completion","facebook-comment","facebook-follow","facebook-like","image-analysis-object-detection","image-analysis-receipt-detection","instagram-follow","instagram-like","instagram-comment","instagram-share","instagram-post","interaction-engage-with-content","interaction-external-link","interaction-image-upload","interaction-spot-object","platform-comment-on-post","platform-complete-achievement","platform-generative-action","platform-like-post","platform-play-game","platform-validate-event","question-multiple-choice","question-open-ended","question-rate-your-experience","question-secret-access-code","question-select-date","question-select-from-images","question-select-value-in-range","question-select-from-list","question-closed-ended","question-vote","spotify-follow","spotify-listen","spotify-save","tiktok-follow","tiktok-watch","tiktok-post","youtube-like","youtube-comment","youtube-subscribe","action-completion","skip-action","42-school","api-auth-link","api-token-link","apple","asgardeo","atlassian","auth0","authentik","azure-ad-b2c","azure-ad","azure-devops","battlenet","beyondidentity","box","boxyhq-saml","bungie","click-up","cognito","coinbase","descope","discord","dribbble","dropbox","duende-identity-server6","email","eveonline","facebook","faceit","foursquare","freshbooks","fusionauth","github","gitlab","google","hubspot","identity-server4","instagram","kakao","keycloak","line","linkedin","mailchimp","mailru","mastodon","mattermost","medium","naver","netlify","notion","okta","onelogin","organisation-oidc","osso","osu","passage","patreon","pinterest","pipedrive","reddit","salesforce","slack","spotify","strava","tiktok","todoist","trakt","twitch","twitter","united-effects","vk","wikimedia","wordpress","workos","yandex","youtube","zitadel","zoho","zoom","blog-comment","blog-like","blog-share","blog-view","challenge-started","challenge-completion","challenge-unlock","community-visit","parental-approval-requested","parental-approval-approved","parental-approval-rejected","custom","game-started","game-completed","leaderboard-finish","invite-admin-user","points-credit","points-spend","post-comment","post-like","post-view","reward-redemption","reward-allocation-purchase","reward-giveaway-winner","reward-claim","reward-distribution","manual-distribution","referral-link-used","shop-purchase","share-challenge-details","share-challenge-results","share-community","share-reward","share-post","share-profile","share-anything","streak-extended","profile-picture-added","bio-added","variable-captured","xp-gained","xp-total","xp-leaderboard-topper"],"description":"The sub-category of events to match. This provides more granular filtering within the selected event category.","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters.eventSubCategory","typeLabel":"enum\u003cstring>"},"eventSourceId":{"oneOf":[{"type":"string","description":"Optional identifier for the source of the events. When specified, only events from this source will count towards the achievement progress. For example, a challengeId, or another achievementId","uniqueKey":"queries.items.[INDEX].parameters.eventSourceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional identifier for the source of the events. When specified, only events from this source will count towards the achievement progress. For example, a challengeId, or another achievementId","uniqueKey":"queries.items.[INDEX].parameters.eventSourceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].parameters.eventSourceId","typeLabel":"string | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Optional array of tag ids to filter events by. Only events with all specified tags will count towards the achievement progress.","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$"},"description":"Optional array of tag ids to filter events by. Only events with all specified tags will count towards the achievement progress.","uniqueKey":"queries.items.[INDEX].parameters.tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].parameters.tags","typeLabel":"string[] | null"}},"required":["eventName","eventCategory","eventSubCategory"],"description":"Parameters that define the criteria for matching and filtering events","title":"Event Query Node Parameters","isRequired":true,"uniqueKey":"queries.items.[INDEX].parameters","typeLabel":"Event Query Node Parameters · object"},"isCommunityScoped":{"oneOf":[{"type":"boolean","default":true,"description":"Controls whether the query should only match events within the achievement's community context. When true (default), only community-specific events are included.","uniqueKey":"queries.items.[INDEX].isCommunityScoped.oneOf.0","typeLabel":"boolean"},{"type":"null","default":true,"description":"Controls whether the query should only match events within the achievement's community context. When true (default), only community-specific events are included.","uniqueKey":"queries.items.[INDEX].isCommunityScoped.oneOf.1","typeLabel":"null"}],"uniqueKey":"queries.items.[INDEX].isCommunityScoped","typeLabel":"boolean | null"}},"required":["type","alias","parameters"],"description":"Node that defines a reusable query for filtering and selecting events to be evaluated by condition nodes","title":"Event Query Node","uniqueKey":"queries.items.[INDEX]","typeLabel":"Event Query Node · object"},"description":"The event queries used to measure progress against this achievement's criteria","isRequired":true,"uniqueKey":"queries","typeLabel":"Event Query Node · object[]"},"queryDescriptions":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"queryDescriptions.additionalProperties","typeLabel":"string"},"description":"A map of query alias to user-readable descriptions, useful for displaying in the UI. Can be localised across additional languages.","isRequired":true,"uniqueKey":"queryDescriptions","typeLabel":"object"},"status":{"type":"string","enum":["archived","draft","expired","live","scheduled"],"description":"The status of the achievement","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"availableAsTemplateForOrganisations":{"type":"array","items":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","uniqueKey":"availableAsTemplateForOrganisations.items.[INDEX]","typeLabel":"string"},"description":"The organisations that the achievement is available as a template for","isRequired":true,"uniqueKey":"availableAsTemplateForOrganisations","typeLabel":"string[]"},"isGlobalTemplate":{"type":"boolean","description":"Whether the achievement is a global template","isRequired":true,"uniqueKey":"isGlobalTemplate","typeLabel":"boolean"},"createdAt":{"type":"string","description":"When this achievement was created","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string"},"updatedAt":{"type":"string","description":"When this achievement was last updated","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string"},"rewardDistribution":{"oneOf":[{"type":"object","title":"Entity Reward Distribution","description":"Reward distribution information for this achievement","required":["points","xp","rewardSelectionMethod","distributionEventId","rewardAllocations","numberOfRewardsToReceive"],"properties":{"points":{"type":"number","minimum":0,"description":"Number of points awarded upon completion","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.points","typeLabel":"number"},"xp":{"type":"number","minimum":0,"description":"XP awarded upon completion","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.xp","typeLabel":"number"},"rewardSelectionMethod":{"type":"string","enum":["all","priority","random","select"],"description":"Method for selecting rewards when multiple are available","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardSelectionMethod","typeLabel":"enum\u003cstring>"},"distributionEventId":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"ID of the distribution event managing these rewards","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.distributionEventId","typeLabel":"string"},"rewardAllocations":{"type":"array","items":{"type":"object","properties":{"rewardId":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"ID of the reward","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations.items.[INDEX].rewardId","typeLabel":"string"},"allocationId":{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"ID of the specific allocation within the reward","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations.items.[INDEX].allocationId","typeLabel":"string"},"allocationType":{"type":"string","enum":["assets","entries"],"description":"The type of allocation - either 'assets' for tangible rewards or 'entries' for giveaway entries","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations.items.[INDEX].allocationType","typeLabel":"enum\u003cstring>"},"amountToDistribute":{"type":"number","minimum":1,"description":"The quantity of this specific reward to distribute when this allocation is selected","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations.items.[INDEX].amountToDistribute","typeLabel":"number"}},"required":["rewardId","allocationId","allocationType","amountToDistribute"],"description":"Reference to a specific reward and its allocation","title":"Reward Allocation Reference","uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations.items.[INDEX]","typeLabel":"Reward Allocation Reference · object"},"description":"Array of reward allocations with their types. Filter by allocationType to get counts: assets for tangible rewards, entries for giveaway entries","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.rewardAllocations","typeLabel":"Reward Allocation Reference · object[]"},"numberOfRewardsToReceive":{"type":"number","minimum":0,"description":"Number of rewards the user will receive from the available rewards","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0.numberOfRewardsToReceive","typeLabel":"number"}},"isRequired":true,"uniqueKey":"rewardDistribution.oneOf.0","typeLabel":"Entity Reward Distribution · object"},{"type":"null","description":"Reward distribution information for this achievement","isRequired":true,"uniqueKey":"rewardDistribution.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"rewardDistribution","typeLabel":"Entity Reward Distribution · object | null"},"createdBy":{"type":"string","description":"The admin user who created this achievement","isRequired":true,"uniqueKey":"createdBy","typeLabel":"string"},"updatedBy":{"type":"string","description":"The admin user who last updated this achievement","isRequired":true,"uniqueKey":"updatedBy","typeLabel":"string"},"communityId":{"oneOf":[{"type":"string","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the community this achievement belongs to","uniqueKey":"communityId.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^[0-9a-fA-F]{24}$","description":"The id of the community this achievement belongs to","uniqueKey":"communityId.oneOf.1","typeLabel":"null"}],"uniqueKey":"communityId","typeLabel":"string | null"},"featured":{"oneOf":[{"type":"boolean","description":"Whether the achievement is featured","uniqueKey":"featured.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the achievement is featured","uniqueKey":"featured.oneOf.1","typeLabel":"null"}],"uniqueKey":"featured","typeLabel":"boolean | null"},"startsAt":{"oneOf":[{"type":"string","description":"When this achievement becomes available to the user","uniqueKey":"startsAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this achievement becomes available to the user","uniqueKey":"startsAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"startsAt","typeLabel":"string | null"},"expiresAt":{"oneOf":[{"type":"string","description":"When this achievement expires","uniqueKey":"expiresAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this achievement expires","uniqueKey":"expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"expiresAt","typeLabel":"string | null"}},"required":["id","organisationId","details","progressPeriod","displayMode","tags","campaigns","criteria","queries","queryDescriptions","status","availableAsTemplateForOrganisations","isGlobalTemplate","createdAt","updatedAt","rewardDistribution","createdBy","updatedBy"],"description":"An achievement","title":"Achievement","uniqueKey":"","typeLabel":"Achievement · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","organisationId":"\u003cstring>","details":{"title":"\u003cstring>","description":"\u003cstring>","light":{"primaryImageUrl":"\u003cstring>","secondaryImageUrl":"\u003cstring>"},"dark":{"primaryImageUrl":"\u003cstring>","secondaryImageUrl":"\u003cstring>"}},"progressPeriod":"daily","displayMode":"default","tags":["\u003cstring>"],"campaigns":["\u003cstring>"],"criteria":{"type":"sum","parameters":{"query":"\u003cstring>","operator":"==","attribute":"\u003cstring>","value":123}},"queries":[{"type":"event","alias":"\u003cstring>","parameters":{"eventName":"\u003cstring>","eventCategory":"achievement","eventSubCategory":"achievement-completion","eventSourceId":"\u003cstring>","tags":["\u003cstring>"]},"isCommunityScoped":true}],"queryDescriptions":{},"status":"archived","availableAsTemplateForOrganisations":["\u003cstring>"],"isGlobalTemplate":true,"createdAt":"\u003cstring>","updatedAt":"\u003cstring>","rewardDistribution":{"points":1,"xp":1,"rewardSelectionMethod":"all","distributionEventId":"\u003cstring>","rewardAllocations":[{"rewardId":"\u003cstring>","allocationId":"\u003cstring>","allocationType":"assets","amountToDistribute":2}],"numberOfRewardsToReceive":1},"createdBy":"\u003cstring>","updatedBy":"\u003cstring>","communityId":"\u003cstring>","featured":true,"startsAt":"\u003cstring>","expiresAt":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b1f00d1a-e73d-4a89-a44f-256a013cceae":{"description":"Invalid input data","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Invalid input data","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"BAD_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Error","description":"The error information","example":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]},"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"code":"BAD_REQUEST","message":"Invalid input data","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"},"267f254a-34ca-4a34-b03b-5d93225e0f7b":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"The error message","example":"Internal server error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"The error code","example":"INTERNAL_SERVER_ERROR","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"required":["message"],"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"description":"An array of issues that were responsible for the error","example":[],"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"title":"Error","description":"The error information","example":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]},"uniqueKey":"","typeLabel":"Error · object"},"examples":{"Example":{"title":"Example","value":{"code":"INTERNAL_SERVER_ERROR","message":"Internal server error","issues":[]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0d04aee5-14a8-4cbe-bdea-886653c3f242":{"ApiToken":{"type":"apiKey","in":"header","name":"x-api-token","scopes":[]}}},"servers":{"a3578f1c-2881-4c69-bd19-b47edca235fe":{"url":"https://{subdomain}.nudj.cx/api/v2/admin","description":"Organization API Server","variables":{"subdomain":{"description":"Your organization's subdomain (required)","default":"your-org"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-token","scopes":[]},"schema":{"title":"x-api-token","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiToken","name":"x-api-token"}],"title":"ApiToken"}]},"originalFileLocation":"openapi/admin.json"},"subdomain":"nudj","siteName":"Nudj Platform Documentation","title":"Create a new achievement - Nudj Platform Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-24T12:15:50.871Z","originalFileLocation":"api-reference/admin/post-achievements.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new achievement.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nudj Platform Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new achievement - Nudj Platform Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new achievement.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nudj Platform Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nudj.cx/api-reference/admin/post-achievements\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nudj.mintlify.app/_mintlify/api/og/v2?division=Achievements\u0026amp;title=Create+a+new+achievement\u0026amp;description=Create+a+new+achievement.\u0026amp;theme=b38afa39b71556cd91c41f96\u0026amp;signature=6fc175667d370fa483730d0283965f47d49d136ff03ea0c97e500ab80c9b123e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a new achievement - Nudj Platform Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new achievement.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nudj.mintlify.app/_mintlify/api/og/v2?division=Achievements\u0026amp;title=Create+a+new+achievement\u0026amp;description=Create+a+new+achievement.\u0026amp;theme=b38afa39b71556cd91c41f96\u0026amp;signature=6fc175667d370fa483730d0283965f47d49d136ff03ea0c97e500ab80c9b123e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/nudj/fATeH148tHvCQ7Cy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nudj Platform Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8082A6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nudj.cx/api-reference/admin/post-achievements\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/admin/post-achievements.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nudj.cx/#organization\",\"name\":\"Nudj Platform Documentation\",\"url\":\"https://docs.nudj.cx\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nudj/Fh-MK3NeO4rWK1Z6/logo/nudj-logo.png?fit=max\u0026auto=format\u0026n=Fh-MK3NeO4rWK1Z6\u0026q=85\u0026s=7340cd62c3a41730e5ce025fd75c842b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nudj.cx#website\",\"name\":\"Nudj Platform Documentation\",\"url\":\"https://docs.nudj.cx\",\"publisher\":{\"@id\":\"https://docs.nudj.cx/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nudj.cx/api-reference/admin/post-achievements#webpage\",\"url\":\"https://docs.nudj.cx/api-reference/admin/post-achievements\",\"name\":\"Create a new achievement\",\"description\":\"Create a new achievement.\",\"dateModified\":\"2026-03-24T12:15:50.871Z\",\"isPartOf\":{\"@id\":\"https://docs.nudj.cx#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nudj.cx/api-reference/admin/post-achievements#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nudj.cx/api-reference/admin/post-achievements#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Achievements\",\"item\":\"https://docs.nudj.cx/api-reference/admin/get-achievements\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new achievement\",\"item\":\"https://docs.nudj.cx/api-reference/admin/post-achievements\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nudj.cx/api-reference/admin/post-achievements#apireference\",\"headline\":\"Create a new achievement\",\"name\":\"Create a new achievement\",\"description\":\"Create a new achievement.\",\"url\":\"https://docs.nudj.cx/api-reference/admin/post-achievements\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nudj.cx/api-reference/admin/post-achievements#webpage\"},\"dateModified\":\"2026-03-24T12:15:50.871Z\",\"publisher\":{\"@id\":\"https://docs.nudj.cx/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nudj.cx#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nudj Platform Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nudj Platform Documentation","nav":{"global":null,"tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/introduction"}]},{"tab":"What's New","pages":[{"title":"What's New","href":"/whats-new"}]},{"tab":"User Guide","pages":[{"title":"User Guide","href":"/user-guide/introduction"}]},{"tab":"Control Room","pages":[{"title":"Control Room","href":"/admin-guide/introduction"}]},{"tab":"Enterprise","pages":[{"title":"Enterprise","href":"/enterprise/platform-overview"}]},{"tab":"Shopify","pages":[{"title":"Shopify","href":"/shopify"}]},{"tab":"Developer","pages":[{"title":"Developer","href":"/api-reference/introduction"}]},{"tab":"Integration API","pages":[{"title":"Integration API","href":"/api-reference/integration/get-achievements"}]},{"tab":"Admin API","groups":[{"group":"Achievements","pages":[{"title":"Get paginated achievements","openapi":"openapi/admin.json GET /achievements","href":"/api-reference/admin/get-achievements"},{"title":"Get achievement by ID","openapi":"openapi/admin.json GET /achievements/{achievementId}","href":"/api-reference/admin/get-achievements-achievementId"},{"title":"Get a distribution details for an achievement","openapi":"openapi/admin.json GET /achievements/{achievementId}/distribution","description":"Get a distribution details for an achievement.","href":"/api-reference/admin/get-achievements-achievementId-distribution"},{"title":"Create a new achievement","openapi":"openapi/admin.json POST /achievements","href":"/api-reference/admin/post-achievements"},{"title":"Assign a distribution details to an achievement","openapi":"openapi/admin.json POST /achievements/{achievementId}/distribution","description":"Assign a distribution details to an achievement.","href":"/api-reference/admin/post-achievements-achievementId-distribution"},{"title":"Update an achievement by id","openapi":"openapi/admin.json POST /achievements/{id}","href":"/api-reference/admin/post-achievements-id"}]},{"group":"Action Participations","pages":[{"title":"Get paginated action participations","openapi":"openapi/admin.json GET /action-participations","href":"/api-reference/admin/get-action-participations"},{"title":"Get action participation by ID","openapi":"openapi/admin.json GET /action-participations/{actionParticipationId}","href":"/api-reference/admin/get-action-participations-actionParticipationId"}]},{"group":"Actions","pages":[{"title":"Delete an action by id","openapi":"openapi/admin.json DELETE /actions/{id}","href":"/api-reference/admin/delete-actions-id"},{"title":"Get paginated actions","openapi":"openapi/admin.json GET /actions","href":"/api-reference/admin/get-actions"},{"title":"Get action by ID","openapi":"openapi/admin.json GET /actions/{actionId}","href":"/api-reference/admin/get-actions-actionId"},{"title":"Get a distribution details for an action","openapi":"openapi/admin.json GET /actions/{actionId}/distribution","href":"/api-reference/admin/get-actions-actionId-distribution"},{"title":"Reorder actions in a challenge","openapi":"openapi/admin.json PATCH /actions/reorder","href":"/api-reference/admin/patch-actions-reorder"},{"title":"Create a new action","openapi":"openapi/admin.json POST /actions","href":"/api-reference/admin/post-actions"},{"title":"Assign a distribution details to an action","openapi":"openapi/admin.json POST /actions/{actionId}/distribution","href":"/api-reference/admin/post-actions-actionId-distribution"},{"title":"Update an action by id","openapi":"openapi/admin.json POST /actions/{id}","href":"/api-reference/admin/post-actions-id"}]},{"group":"Auth Config","pages":[{"title":"Get auth configuration","openapi":"openapi/admin.json GET /auth-config","href":"/api-reference/admin/get-auth-config"},{"title":"Update auth configuration","openapi":"openapi/admin.json PATCH /auth-config","href":"/api-reference/admin/patch-auth-config"},{"title":"Revoke API token","openapi":"openapi/admin.json POST /auth-config/tokens/{tokenId}/revoke","href":"/api-reference/admin/post-auth-config-tokens-tokenId-revoke"}]},{"group":"Campaigns","pages":[{"title":"Get paginated campaigns","openapi":"openapi/admin.json GET /campaigns","href":"/api-reference/admin/get-campaigns"},{"title":"Get campaign by ID","openapi":"openapi/admin.json GET /campaigns/{id}","href":"/api-reference/admin/get-campaigns-id"},{"title":"Update an existing campaign","openapi":"openapi/admin.json PATCH /campaigns/{id}","href":"/api-reference/admin/patch-campaigns-id"},{"title":"Create a new campaign","openapi":"openapi/admin.json POST /campaigns","href":"/api-reference/admin/post-campaigns"}]},{"group":"Challenge Groups","pages":[{"title":"Get paginated challenge groups","openapi":"openapi/admin.json GET /challenge-groups","href":"/api-reference/admin/get-challenge-groups"},{"title":"Get challenge group by ID","openapi":"openapi/admin.json GET /challenge-groups/{id}","href":"/api-reference/admin/get-challenge-groups-id"},{"title":"Update a challenge group by id","openapi":"openapi/admin.json PATCH /challenge-groups/{id}","href":"/api-reference/admin/patch-challenge-groups-id"},{"title":"Create a new challenge group","openapi":"openapi/admin.json POST /challenge-groups","href":"/api-reference/admin/post-challenge-groups"}]},{"group":"Challenges","pages":[{"title":"Get paginated challenges","openapi":"openapi/admin.json GET /challenges","href":"/api-reference/admin/get-challenges"},{"title":"Get challenge by ID","openapi":"openapi/admin.json GET /challenges/{challengeId}","href":"/api-reference/admin/get-challenges-challengeId"},{"title":"Get a distribution details for a challenge","openapi":"openapi/admin.json GET /challenges/{challengeId}/distribution","href":"/api-reference/admin/get-challenges-challengeId-distribution"},{"title":"Create a new challenge","openapi":"openapi/admin.json POST /challenges","href":"/api-reference/admin/post-challenges"},{"title":"Assign a distribution details to a challenge","openapi":"openapi/admin.json POST /challenges/{challengeId}/distribution","href":"/api-reference/admin/post-challenges-challengeId-distribution"},{"title":"Update a challenge by id","openapi":"openapi/admin.json POST /challenges/{id}","href":"/api-reference/admin/post-challenges-id"}]},{"group":"Communities","pages":[{"title":"Get paginated communities","openapi":"openapi/admin.json GET /communities","href":"/api-reference/admin/get-communities"},{"title":"Get community by ID","openapi":"openapi/admin.json GET /communities/{communityId}","href":"/api-reference/admin/get-communities-communityId"},{"title":"Create a new community","openapi":"openapi/admin.json POST /communities","href":"/api-reference/admin/post-communities"},{"title":"Update a community by id","openapi":"openapi/admin.json POST /communities/{id}","href":"/api-reference/admin/post-communities-id"}]},{"group":"Domains","pages":[{"title":"Get domain configuration","openapi":"openapi/admin.json GET /domains","href":"/api-reference/admin/get-domains"},{"title":"Add a domain","openapi":"openapi/admin.json POST /domains","href":"/api-reference/admin/post-domains"},{"title":"Remove a domain","openapi":"openapi/admin.json POST /domains/remove","href":"/api-reference/admin/post-domains-remove"}]},{"group":"Events","pages":[{"title":"Create a new custom event","openapi":"openapi/admin.json POST /events/custom","href":"/api-reference/admin/post-events-custom"},{"title":"Create a new event link","openapi":"openapi/admin.json POST /events/custom/link","href":"/api-reference/admin/post-events-custom-link"}]},{"group":"Feature Flags","pages":[{"title":"Get all feature flags","openapi":"openapi/admin.json GET /feature-flags","href":"/api-reference/admin/get-feature-flags"},{"title":"Update feature flags","openapi":"openapi/admin.json PATCH /feature-flags","href":"/api-reference/admin/patch-feature-flags"}]},{"group":"Game","pages":[{"title":"Delete a game config by id","openapi":"openapi/admin.json DELETE /game-configs/{id}","href":"/api-reference/admin/delete-game-configs-id"},{"title":"Get paginated game configs","openapi":"openapi/admin.json GET /game-configs","href":"/api-reference/admin/get-game-configs"},{"title":"Get game config by ID","openapi":"openapi/admin.json GET /game-configs/{id}","href":"/api-reference/admin/get-game-configs-id"},{"title":"Update a game config","openapi":"openapi/admin.json PATCH /game-configs/{id}","href":"/api-reference/admin/patch-game-configs-id"},{"title":"Create a game config","openapi":"openapi/admin.json POST /game-configs","href":"/api-reference/admin/post-game-configs"}]},{"group":"Games","pages":[{"title":"Assign distribution details to a game config","openapi":"openapi/admin.json POST /games/{gameConfigId}/distribution","href":"/api-reference/admin/post-games-gameConfigId-distribution"}]},{"group":"Languages","pages":[{"title":"Get language configurations","openapi":"openapi/admin.json GET /languages","href":"/api-reference/admin/get-languages"},{"title":"Update language configuration","openapi":"openapi/admin.json POST /languages/{language}","href":"/api-reference/admin/post-languages-language"}]},{"group":"Leaderboards","pages":[{"title":"Get aggregated leaderboard data","openapi":"openapi/admin.json GET /leaderboards/{configId}/data","href":"/api-reference/admin/get-leaderboards-configId-data"},{"title":"Get paginated leaderboard configurations","openapi":"openapi/admin.json GET /leaderboards/configs","href":"/api-reference/admin/get-leaderboards-configs"},{"title":"Get leaderboard config by ID","openapi":"openapi/admin.json GET /leaderboards/configs/{leaderboardConfigId}","href":"/api-reference/admin/get-leaderboards-configs-leaderboardConfigId"},{"title":"Get distribution details for a leaderboard config","openapi":"openapi/admin.json GET /leaderboards/{leaderboardConfigId}/distribution","href":"/api-reference/admin/get-leaderboards-leaderboardConfigId-distribution"},{"title":"Update a leaderboard configuration","openapi":"openapi/admin.json PATCH /leaderboards/configs/{id}","href":"/api-reference/admin/patch-leaderboards-configs-id"},{"title":"Create a new leaderboard configuration","openapi":"openapi/admin.json POST /leaderboards","href":"/api-reference/admin/post-leaderboards"},{"title":"Create default leaderboard configs","openapi":"openapi/admin.json POST /leaderboards/default","href":"/api-reference/admin/post-leaderboards-default"},{"title":"Assign distribution details to a leaderboard config","openapi":"openapi/admin.json POST /leaderboards/{leaderboardConfigId}/distribution","href":"/api-reference/admin/post-leaderboards-leaderboardConfigId-distribution"}]},{"group":"Legal Policies","pages":[{"title":"Get legal policies","openapi":"openapi/admin.json GET /legal-policies","href":"/api-reference/admin/get-legal-policies"},{"title":"Update legal policies","openapi":"openapi/admin.json PATCH /legal-policies","href":"/api-reference/admin/patch-legal-policies"}]},{"group":"Organisations","pages":[{"title":"Get organisation by ID","openapi":"openapi/admin.json GET /organisations/{organisationId}","href":"/api-reference/admin/get-organisations-organisationId"},{"title":"Update an organisation","openapi":"openapi/admin.json PATCH /organisations/{id}","href":"/api-reference/admin/patch-organisations-id"},{"title":"Create a new organisation","openapi":"openapi/admin.json POST /organisations","href":"/api-reference/admin/post-organisations"}]},{"group":"Posts","pages":[{"title":"Get paginated posts","openapi":"openapi/admin.json GET /posts","href":"/api-reference/admin/get-posts"},{"title":"Get post by id","openapi":"openapi/admin.json GET /posts/{postId}","href":"/api-reference/admin/get-posts-postId"},{"title":"Create a new post","openapi":"openapi/admin.json POST /posts","href":"/api-reference/admin/post-posts"},{"title":"Update a post by id","openapi":"openapi/admin.json POST /posts/{id}","href":"/api-reference/admin/post-posts-id"}]},{"group":"Rewards","pages":[{"title":"Get paginated rewards","openapi":"openapi/admin.json GET /rewards","href":"/api-reference/admin/get-rewards"},{"title":"Get reward by ID","openapi":"openapi/admin.json GET /rewards/{rewardId}","href":"/api-reference/admin/get-rewards-rewardId"},{"title":"Get paginated reward entries for a specific reward","openapi":"openapi/admin.json GET /rewards/{rewardId}/entries","href":"/api-reference/admin/get-rewards-rewardId-entries"},{"title":"Get paginated reward redemption values for a specific reward","openapi":"openapi/admin.json GET /rewards/{rewardId}/redemption-values","href":"/api-reference/admin/get-rewards-rewardId-redemption-values"},{"title":"Create a reward","openapi":"openapi/admin.json POST /rewards","href":"/api-reference/admin/post-rewards"},{"title":"Update a reward by id","openapi":"openapi/admin.json POST /rewards/{id}","href":"/api-reference/admin/post-rewards-id"},{"title":"Process manual reward distribution","openapi":"openapi/admin.json POST /rewards/manual-distribution","href":"/api-reference/admin/post-rewards-manual-distribution"},{"title":"Process manual reward giveaway","openapi":"openapi/admin.json POST /rewards/{rewardId}/process-giveaway","href":"/api-reference/admin/post-rewards-rewardId-process-giveaway"},{"title":"Process reward redemption values from CSV","openapi":"openapi/admin.json POST /rewards/{rewardId}/redemption-values","href":"/api-reference/admin/post-rewards-rewardId-redemption-values"}]},{"group":"Streaks","pages":[{"title":"Get paginated streak configs","openapi":"openapi/admin.json GET /streaks/configs","href":"/api-reference/admin/get-streaks-configs"},{"title":"Get streak config by ID","openapi":"openapi/admin.json GET /streaks/configs/{id}","href":"/api-reference/admin/get-streaks-configs-id"},{"title":"Update a streak config by id","openapi":"openapi/admin.json PATCH /streaks/configs/{id}","href":"/api-reference/admin/patch-streaks-configs-id"}]},{"group":"Tags","pages":[{"title":"Delete a tag by id","openapi":"openapi/admin.json DELETE /tags/{id}","href":"/api-reference/admin/delete-tags-id"},{"title":"Get paginated tags","openapi":"openapi/admin.json GET /tags","href":"/api-reference/admin/get-tags"},{"title":"Get tag by ID","openapi":"openapi/admin.json GET /tags/{id}","href":"/api-reference/admin/get-tags-id"},{"title":"Update a tag by ID","openapi":"openapi/admin.json PATCH /tags/{id}","href":"/api-reference/admin/patch-tags-id"},{"title":"Create a new tag","openapi":"openapi/admin.json POST /tags","href":"/api-reference/admin/post-tags"}]},{"group":"Teams","pages":[{"title":"Remove a user from an organisation","openapi":"openapi/admin.json DELETE /teams/{userId}","href":"/api-reference/admin/delete-teams-userId"},{"title":"Get paginated team members","openapi":"openapi/admin.json GET /teams","href":"/api-reference/admin/get-teams"},{"title":"Invite users to an organisation","openapi":"openapi/admin.json POST /teams/invite","href":"/api-reference/admin/post-teams-invite"}]},{"group":"Templates","pages":[{"title":"Get paginated achievement templates","openapi":"openapi/admin.json GET /templates/achievements","href":"/api-reference/admin/get-templates-achievements"},{"title":"Get paginated action templates","openapi":"openapi/admin.json GET /templates/actions","href":"/api-reference/admin/get-templates-actions"},{"title":"Get paginated challenge templates","openapi":"openapi/admin.json GET /templates/challenges","href":"/api-reference/admin/get-templates-challenges"},{"title":"Get paginated community templates","openapi":"openapi/admin.json GET /templates/communities","href":"/api-reference/admin/get-templates-communities"},{"title":"Get paginated post templates","openapi":"openapi/admin.json GET /templates/posts","href":"/api-reference/admin/get-templates-posts"},{"title":"Get paginated reward templates","openapi":"openapi/admin.json GET /templates/rewards","href":"/api-reference/admin/get-templates-rewards"},{"title":"Create a new entity from a template","openapi":"openapi/admin.json POST /templates/create-entity","href":"/api-reference/admin/post-templates-create-entity"}]},{"group":"Themes","pages":[{"title":"Get theme configuration","openapi":"openapi/admin.json GET /themes","href":"/api-reference/admin/get-themes"},{"title":"Update theme configuration","openapi":"openapi/admin.json PATCH /themes","href":"/api-reference/admin/patch-themes"}]},{"group":"Third Party Config","pages":[{"title":"Get third party configuration","openapi":"openapi/admin.json GET /third-party-config","href":"/api-reference/admin/get-third-party-config"},{"title":"Update third party configuration","openapi":"openapi/admin.json PATCH /third-party-config","href":"/api-reference/admin/patch-third-party-config"},{"title":"Generate Shopify linking code","openapi":"openapi/admin.json POST /third-party-config/initiate-shopify-connection","href":"/api-reference/admin/post-third-party-config-initiate-shopify-connection"}]},{"group":"Users","pages":[{"title":"Delete user personal data","openapi":"openapi/admin.json DELETE /users/{id}","href":"/api-reference/admin/delete-users-id"},{"title":"Get paginated users","openapi":"openapi/admin.json GET /users","href":"/api-reference/admin/get-users"},{"title":"Get user by ID","openapi":"openapi/admin.json GET /users/{id}","href":"/api-reference/admin/get-users-id"},{"title":"Create user","openapi":"openapi/admin.json POST /users","href":"/api-reference/admin/post-users"},{"title":"Manage points transaction","openapi":"openapi/admin.json POST /users/{id}/points-transaction","href":"/api-reference/admin/post-users-id-points-transaction"},{"title":"Sync user to external account","openapi":"openapi/admin.json POST /users/sync-to-external-account","href":"/api-reference/admin/post-users-sync-to-external-account"}]},{"group":"Variables","pages":[{"title":"Get paginated variable configs","openapi":"openapi/admin.json GET /variables","href":"/api-reference/admin/get-variables"},{"title":"Get variable config by ID","openapi":"openapi/admin.json GET /variables/{variableConfigId}","href":"/api-reference/admin/get-variables-variableConfigId"},{"title":"Get paginated variable values for a specific variable config","openapi":"openapi/admin.json GET /variables/{variableConfigId}/values","href":"/api-reference/admin/get-variables-variableConfigId-values"},{"title":"Update an existing variable config","openapi":"openapi/admin.json PATCH /variables/{id}","href":"/api-reference/admin/patch-variables-id"},{"title":"Create a new variable config","openapi":"openapi/admin.json POST /variables","href":"/api-reference/admin/post-variables"}]},{"group":"Webhooks","pages":[{"title":"Get webhook configurations","openapi":"openapi/admin.json GET /webhooks/configs","href":"/api-reference/admin/get-webhooks-configs"},{"title":"Get paginated webhook logs","openapi":"openapi/admin.json GET /webhooks/logs","href":"/api-reference/admin/get-webhooks-logs"},{"title":"Update webhook configurations","openapi":"openapi/admin.json PUT /webhooks/configs","href":"/api-reference/admin/put-webhooks-configs"}]},{"group":"Xp","pages":[{"title":"Get XP configuration","openapi":"openapi/admin.json GET /xp-config","href":"/api-reference/admin/get-xp-config"},{"title":"Update XP configuration","openapi":"openapi/admin.json PATCH /xp-config","href":"/api-reference/admin/patch-xp-config"}]},{"group":"Achievement","pages":[{"title":"Get achievement by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /achievements/{achievementId}","href":"/api-reference/achievement/get-achievement-by-id"},{"title":"Get paginated achievements","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /achievements","href":"/api-reference/achievement/get-paginated-achievements"},{"title":"Create a new achievement","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /achievements","href":"/api-reference/achievement/create-a-new-achievement"},{"title":"Update an achievement by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /achievements/{id}","href":"/api-reference/achievement/update-an-achievement-by-id"},{"title":"Get a distribution details for an achievement","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /achievements/{achievementId}/distribution","href":"/api-reference/achievement/get-a-distribution-details-for-an-achievement"},{"title":"Assign a distribution details to an achievement","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /achievements/{achievementId}/distribution","href":"/api-reference/achievement/assign-a-distribution-details-to-an-achievement"}]},{"group":"Action Participation","pages":[{"title":"Get action participation by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /action-participations/{actionParticipationId}","href":"/api-reference/action-participation/get-action-participation-by-id"},{"title":"Get paginated action participations","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /action-participations","href":"/api-reference/action-participation/get-paginated-action-participations"}]},{"group":"Action","pages":[{"title":"Get paginated actions","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /actions","href":"/api-reference/action/get-paginated-actions"},{"title":"Create a new action","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /actions","href":"/api-reference/action/create-a-new-action"},{"title":"Update an action by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /actions/{id}","href":"/api-reference/action/update-an-action-by-id"},{"title":"Delete an action by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json delete /actions/{id}","href":"/api-reference/action/delete-an-action-by-id"},{"title":"Get action by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /actions/{actionId}","href":"/api-reference/action/get-action-by-id"},{"title":"Reorder actions in a challenge","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /actions/reorder","href":"/api-reference/action/reorder-actions-in-a-challenge"},{"title":"Get a distribution details for an action","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /actions/{actionId}/distribution","href":"/api-reference/action/get-a-distribution-details-for-an-action"},{"title":"Assign a distribution details to an action","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /actions/{actionId}/distribution","href":"/api-reference/action/assign-a-distribution-details-to-an-action"}]},{"group":"Auth Config","pages":[{"title":"Get auth configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /auth-config","href":"/api-reference/auth-config/get-auth-configuration"},{"title":"Update auth configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /auth-config","href":"/api-reference/auth-config/update-auth-configuration"},{"title":"Revoke API token","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /auth-config/tokens/{tokenId}/revoke","href":"/api-reference/auth-config/revoke-api-token"}]},{"group":"Community","pages":[{"title":"Get paginated communities","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /communities","href":"/api-reference/community/get-paginated-communities"},{"title":"Create a new community","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /communities","href":"/api-reference/community/create-a-new-community"},{"title":"Update a community by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /communities/{id}","href":"/api-reference/community/update-a-community-by-id"},{"title":"Get community by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /communities/{communityId}","href":"/api-reference/community/get-community-by-id"}]},{"group":"Challenge Group","pages":[{"title":"Get challenge group by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /challenge-groups/{id}","href":"/api-reference/challenge-group/get-challenge-group-by-id"},{"title":"Update a challenge group by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /challenge-groups/{id}","href":"/api-reference/challenge-group/update-a-challenge-group-by-id"},{"title":"Get paginated challenge groups","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /challenge-groups","href":"/api-reference/challenge-group/get-paginated-challenge-groups"},{"title":"Create a new challenge group","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /challenge-groups","href":"/api-reference/challenge-group/create-a-new-challenge-group"}]},{"group":"Challenge","pages":[{"title":"Get challenge by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /challenges/{challengeId}","href":"/api-reference/challenge/get-challenge-by-id"},{"title":"Get paginated challenges","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /challenges","href":"/api-reference/challenge/get-paginated-challenges"},{"title":"Create a new challenge","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /challenges","href":"/api-reference/challenge/create-a-new-challenge"},{"title":"Update a challenge by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /challenges/{id}","href":"/api-reference/challenge/update-a-challenge-by-id"},{"title":"Get a distribution details for a challenge","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /challenges/{challengeId}/distribution","href":"/api-reference/challenge/get-a-distribution-details-for-a-challenge"},{"title":"Assign a distribution details to a challenge","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /challenges/{challengeId}/distribution","href":"/api-reference/challenge/assign-a-distribution-details-to-a-challenge"}]},{"group":"Domains","pages":[{"title":"Get domain configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /domains","href":"/api-reference/domains/get-domain-configuration"},{"title":"Add a domain","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /domains","href":"/api-reference/domains/add-a-domain"},{"title":"Remove a domain","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /domains/remove","href":"/api-reference/domains/remove-a-domain"}]},{"group":"Event","pages":[{"title":"Create a new event link","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /events/custom/link","href":"/api-reference/event/create-a-new-event-link"},{"title":"Create a new custom event","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /events/custom","href":"/api-reference/event/create-a-new-custom-event"}]},{"group":"Feature Flags","pages":[{"title":"Get all feature flags","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /feature-flags","href":"/api-reference/feature-flags/get-all-feature-flags"},{"title":"Update feature flags","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /feature-flags","href":"/api-reference/feature-flags/update-feature-flags"}]},{"group":"Language","pages":[{"title":"Get language configurations","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /languages","href":"/api-reference/language/get-language-configurations"},{"title":"Update language configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /languages/{language}","href":"/api-reference/language/update-language-configuration"}]},{"group":"Leaderboard","pages":[{"title":"Create a new leaderboard configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /leaderboards","href":"/api-reference/leaderboard/create-a-new-leaderboard-configuration"},{"title":"Create default leaderboard configs","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /leaderboards/default","href":"/api-reference/leaderboard/create-default-leaderboard-configs"},{"title":"Get paginated leaderboard configurations","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /leaderboards/configs","href":"/api-reference/leaderboard/get-paginated-leaderboard-configurations"},{"title":"Get leaderboard config by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /leaderboards/configs/{leaderboardConfigId}","href":"/api-reference/leaderboard/get-leaderboard-config-by-id"},{"title":"Export fresh leaderboard rankings","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /leaderboards/export","href":"/api-reference/leaderboard/export-fresh-leaderboard-rankings"},{"title":"Get aggregated leaderboard data","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /leaderboards/{configId}/data","href":"/api-reference/leaderboard/get-aggregated-leaderboard-data"},{"title":"Update a leaderboard configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /leaderboards/configs/{id}","href":"/api-reference/leaderboard/update-a-leaderboard-configuration"},{"title":"Get distribution details for a leaderboard config","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /leaderboards/{leaderboardConfigId}/distribution","href":"/api-reference/leaderboard/get-distribution-details-for-a-leaderboard-config"},{"title":"Assign distribution details to a leaderboard config","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /leaderboards/{leaderboardConfigId}/distribution","href":"/api-reference/leaderboard/assign-distribution-details-to-a-leaderboard-config"}]},{"group":"Legal Policies","pages":[{"title":"Get legal policies","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /legal-policies","href":"/api-reference/legal-policies/get-legal-policies"},{"title":"Update legal policies","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /legal-policies","href":"/api-reference/legal-policies/update-legal-policies"}]},{"group":"Organisation","pages":[{"title":"Create a new organisation","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /organisations","href":"/api-reference/organisation/create-a-new-organisation"},{"title":"Get organisation by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /organisations/{organisationId}","href":"/api-reference/organisation/get-organisation-by-id"},{"title":"Update an organisation","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /organisations/{id}","href":"/api-reference/organisation/update-an-organisation"}]},{"group":"Post","pages":[{"title":"Get paginated posts","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /posts","href":"/api-reference/post/get-paginated-posts"},{"title":"Create a new post","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /posts","href":"/api-reference/post/create-a-new-post"},{"title":"Get post by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /posts/{postId}","href":"/api-reference/post/get-post-by-id"},{"title":"Update a post by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /posts/{id}","href":"/api-reference/post/update-a-post-by-id"}]},{"group":"Reward","pages":[{"title":"Process manual reward distribution","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /rewards/manual-distribution","href":"/api-reference/reward/process-manual-reward-distribution"},{"title":"Get reward by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /rewards/{rewardId}","href":"/api-reference/reward/get-reward-by-id"},{"title":"Get paginated rewards","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /rewards","href":"/api-reference/reward/get-paginated-rewards"},{"title":"Create a reward","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /rewards","href":"/api-reference/reward/create-a-reward"},{"title":"Get paginated reward entries for a specific reward","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /rewards/{rewardId}/entries","href":"/api-reference/reward/get-paginated-reward-entries-for-a-specific-reward"},{"title":"Get paginated reward redemption values for a specific reward","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /rewards/{rewardId}/redemption-values","href":"/api-reference/reward/get-paginated-reward-redemption-values-for-a-specific-reward"},{"title":"Process reward redemption values from CSV","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /rewards/{rewardId}/redemption-values","href":"/api-reference/reward/process-reward-redemption-values-from-csv"},{"title":"Process manual reward giveaway","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /rewards/{rewardId}/process-giveaway","href":"/api-reference/reward/process-manual-reward-giveaway"},{"title":"Update a reward by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /rewards/{id}","href":"/api-reference/reward/update-a-reward-by-id"}]},{"group":"Game Config","pages":[{"title":"Get paginated game configs","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /game-configs","href":"/api-reference/game-config/get-paginated-game-configs"},{"title":"Create a game config","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /game-configs","href":"/api-reference/game-config/create-a-game-config"},{"title":"Get game config by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /game-configs/{id}","href":"/api-reference/game-config/get-game-config-by-id"},{"title":"Delete a game config by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json delete /game-configs/{id}","href":"/api-reference/game-config/delete-a-game-config-by-id"},{"title":"Update a game config","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /game-configs/{id}","href":"/api-reference/game-config/update-a-game-config"},{"title":"Assign distribution details to a game config","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /games/{gameConfigId}/distribution","href":"/api-reference/game-config/assign-distribution-details-to-a-game-config"}]},{"group":"Streak","pages":[{"title":"Get paginated streak configs","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /streaks/configs","href":"/api-reference/streak/get-paginated-streak-configs"},{"title":"Get streak config by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /streaks/configs/{id}","href":"/api-reference/streak/get-streak-config-by-id"},{"title":"Update a streak config by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /streaks/configs/{id}","href":"/api-reference/streak/update-a-streak-config-by-id"}]},{"group":"Tag","pages":[{"title":"Get paginated tags","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /tags","href":"/api-reference/tag/get-paginated-tags"},{"title":"Create a new tag","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /tags","href":"/api-reference/tag/create-a-new-tag"},{"title":"Get tag by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /tags/{id}","href":"/api-reference/tag/get-tag-by-id"},{"title":"Delete a tag by id","deprecated":null,"version":null,"openapi":"/openapi/admin.json delete /tags/{id}","href":"/api-reference/tag/delete-a-tag-by-id"},{"title":"Update a tag by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /tags/{id}","href":"/api-reference/tag/update-a-tag-by-id"}]},{"group":"Team","pages":[{"title":"Get paginated team members","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /teams","href":"/api-reference/team/get-paginated-team-members"},{"title":"Invite users to an organisation","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /teams/invite","href":"/api-reference/team/invite-users-to-an-organisation"},{"title":"Remove a user from an organisation","deprecated":null,"version":null,"openapi":"/openapi/admin.json delete /teams/{userId}","href":"/api-reference/team/remove-a-user-from-an-organisation"}]},{"group":"Templates","pages":[{"title":"Create a new entity from a template","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /templates/create-entity","href":"/api-reference/templates/create-a-new-entity-from-a-template"},{"title":"Get paginated community templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/communities","href":"/api-reference/templates/get-paginated-community-templates"},{"title":"Get paginated action templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/actions","href":"/api-reference/templates/get-paginated-action-templates"},{"title":"Get paginated challenge templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/challenges","href":"/api-reference/templates/get-paginated-challenge-templates"},{"title":"Get paginated achievement templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/achievements","href":"/api-reference/templates/get-paginated-achievement-templates"},{"title":"Get paginated reward templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/rewards","href":"/api-reference/templates/get-paginated-reward-templates"},{"title":"Get paginated post templates","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /templates/posts","href":"/api-reference/templates/get-paginated-post-templates"}]},{"group":"Theme","pages":[{"title":"Get theme configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /themes","href":"/api-reference/theme/get-theme-configuration"},{"title":"Update theme configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /themes","href":"/api-reference/theme/update-theme-configuration"}]},{"group":"Third Party Config","pages":[{"title":"Get third party configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /third-party-config","href":"/api-reference/third-party-config/get-third-party-configuration"},{"title":"Update third party configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /third-party-config","href":"/api-reference/third-party-config/update-third-party-configuration"}]},{"group":"Shopify","pages":[{"title":"Generate Shopify linking code","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /third-party-config/initiate-shopify-connection","href":"/api-reference/shopify/generate-shopify-linking-code"}]},{"group":"User","pages":[{"title":"Get paginated users","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /users","href":"/api-reference/user/get-paginated-users"},{"title":"Create user","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /users","href":"/api-reference/user/create-user"},{"title":"Get user by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /users/{id}","href":"/api-reference/user/get-user-by-id"},{"title":"Delete user personal data","deprecated":null,"version":null,"openapi":"/openapi/admin.json delete /users/{id}","href":"/api-reference/user/delete-user-personal-data"},{"title":"Manage points transaction","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /users/{id}/points-transaction","href":"/api-reference/user/manage-points-transaction"},{"title":"Sync user to external account","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /users/sync-to-external-account","href":"/api-reference/user/sync-user-to-external-account"}]},{"group":"Variable","pages":[{"title":"Get paginated variable configs","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /variables","href":"/api-reference/variable/get-paginated-variable-configs"},{"title":"Create a new variable config","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /variables","href":"/api-reference/variable/create-a-new-variable-config"},{"title":"Get paginated variable values for a specific variable config","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /variables/{variableConfigId}/values","href":"/api-reference/variable/get-paginated-variable-values-for-a-specific-variable-config"},{"title":"Get variable config by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /variables/{variableConfigId}","href":"/api-reference/variable/get-variable-config-by-id"},{"title":"Update an existing variable config","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /variables/{id}","href":"/api-reference/variable/update-an-existing-variable-config"}]},{"group":"Webhooks","pages":[{"title":"Get webhook configurations","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /webhooks/configs","href":"/api-reference/webhooks/get-webhook-configurations"},{"title":"Update webhook configurations","deprecated":null,"version":null,"openapi":"/openapi/admin.json put /webhooks/configs","href":"/api-reference/webhooks/update-webhook-configurations"},{"title":"Get paginated webhook logs","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /webhooks/logs","href":"/api-reference/webhooks/get-paginated-webhook-logs"}]},{"group":"XP Config","pages":[{"title":"Get XP configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /xp-config","href":"/api-reference/xp-config/get-xp-configuration"},{"title":"Update XP configuration","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /xp-config","href":"/api-reference/xp-config/update-xp-configuration"}]},{"group":"Campaign","pages":[{"title":"Get paginated campaigns","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /campaigns","href":"/api-reference/campaign/get-paginated-campaigns"},{"title":"Create a new campaign","deprecated":null,"version":null,"openapi":"/openapi/admin.json post /campaigns","href":"/api-reference/campaign/create-a-new-campaign"},{"title":"Get campaign by ID","deprecated":null,"version":null,"openapi":"/openapi/admin.json get /campaigns/{id}","href":"/api-reference/campaign/get-campaign-by-id"},{"title":"Update an existing campaign","deprecated":null,"version":null,"openapi":"/openapi/admin.json patch /campaigns/{id}","href":"/api-reference/campaign/update-an-existing-campaign"}]}]},{"tab":"Analytics API","pages":[{"title":"Analytics API","href":"/api-reference/analytics/get-achievements-stats-criteria-completion"}]}]},"basePath":"","title":"Create a new achievement - Nudj Platform Documentation","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}