Skip to main content
POST
Create app
Creates a new Skin Analysis application configuration under your organization. This app defines SDK behavior, reporting layout, retention policy, and UI settings.
Note
The appId returned in the response will be needed for future API calls.

Request body

namestring
Display name of the Skin Analysis application configuration.
expire_images_after_daysinteger
Number of days after which uploaded analysis images are automatically deleted.
sdkVersionstring
SDK version associated with this app configuration.
algorithmVersionstring
Version of the skin analysis algorithm to use for processing.
report_configobject
Configuration object that defines branding, layout, and report content behavior.
appConfigobject
Configuration object that controls UI behavior, metadata, and domain restrictions.
POST/apps
curl -X POST "https://api.pixelbin.io/service/platform/misc/v1.0/apps" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {apitoken}" \
  -d '{"name":"YOUR_APP_NAME","expire_images_after_days":365,"status":"enabled","meta":{},"sdkVersion":"2.0.0","algorithmVersion":"1.0.0","report_config":{"logo":"https://cdn.pixelbin.io/v2/dummy-cloudname/original/__glam_ar/__console/__skinanalysis/SA_Report_logo.svg","report_titles":{"title":"Your personalized skin report","subtitle":"Generated using AI"},"showConcernVisuals":true,"overallSkinScore":{"skinAge":true,"skinTone":true,"skinType":true,"skinScore":true},"skinConcerns":{"title":"Your detailed skin scores","showDetailedConcernVisual":true,"concerns":{"acne":true,"wrinkles":true,"pores":true,"dark_circles":true,"eye_bags":false,"post_acne_scars":false,"whiteheads":false,"pigmentation":false,"hydration":false}},"features":{"beautyGptChatbot":{"show":false},"futureSkinSimulation":{"show":false,"title":"Your skin journey with GlamAR"},"productRecommendation":{"show":false,"usage":true,"category":true,"sellingPrice":true,"showRedirectLink":true,"addToCart":true,"title":"Products recommended for you"}}},"appConfig":{"ui_config":{"advance":{"allowBack":true,"allowClose":true,"allowPrice":true,"allowWishlist":true,"allowAddToCart":true,"allowFullScreen":true,"allowGlobalCart":true,"allowGlobalShare":true,"allowProductName":true,"allowCameraSwitch":false,"allowGlobalWishlist":true},"general":{"languages":["english"],"watermark":{"allowWaterMark":true}},"screens":{"loadingScreen":{"title":"Generating your report","showLoaderFacts":true,"infoText":["Your skin is your body'\''s largest organ — it covers about 22 square feet!","Oily skin can still be dehydrated. In fact, dehydration often leads to more oil production.","Fine lines and wrinkles can begin to form as early as your 20s — prevention is key!","Sunscreen isn'\''t just for sunny days. UV damage happens even when it'\''s cloudy."]},"instructionScreen":{"banner":{"web":[{"_id":"skin-banner-web","url":"https://cdn.pixelbin.io/v2/dummy-cloudname/original/__glam_ar/__sdk/skin_banner_web.png","size":"205kb","filename":"skin_banner_web.png"}],"mobile":[{"_id":"skin-banner-mobile","url":"https://cdn.pixelbin.io/v2/dummy-cloudname/original/__glam_ar/__sdk/skin_banner_mobile.png","size":"205kb","filename":"skin_banner_mobile.png"}]},"content":{"title":"Instructions to get started","instructions":[{"text":"Remove glasses or face covering"},{"text":"Make sure you are in good lighting"},{"text":"Avoid makeup for best results"}]}}},"appearance":{"theme":{"type":"light","configuration":{"theme":"light","iconColor":"#DA0E64","primaryColor":"#DA0E64","selectionColor":"#FFF5FC"}},"typography":{"font":"Inter"}},"customCode":{"disableToast":true,"openLiveOnInit":false,"popUpOverrides":{"quit":false,"result":false,"restart":false},"screenOverrides":{"heroScreen":false,"domainBlock":false,"billingBlock":false,"cameraFailed":false,"cameraAccessDenied":false,"somethingWentWrong":false}}},"meta":{},"domains":[]}}'
Response
{
  "app": {
    "_id": "fecf3bc7-c9ec-4c47-8555-93a74df48289",
    "org_id": "4278",
    "name": "Test Skin Analysis App",
    "status": "enabled",
    "expire_images_after_days": 365,
    "meta": {},
    "report_config": {
      "logo": "https://cdn.pixelbin.io/v2/dummy-cloudname/original/__glam_ar/__console/__skinanalysis/SA_Report_logo.svg",
      "features": {},
      "skinConcerns": {},
      "report_titles": {},
      "overallSkinScore": {},
      "showConcernVisuals": true
    },
    "created_at": "2026-01-05T09:56:54.678Z",
    "copilot": {},
    "sdkVersion": "2.0.0",
    "algorithmVersion": "1.0.0",
    "appConfig": {
      "_id": "c83bf28b-1e18-4bce-960a-1127091ef1fb",
      "app_id": "b8d27d08-0b31-4b4d-9250-dd7bbb161243",
      "ui_config": {
        "advance": {},
        "general": {
          "languages": [
            "english"
          ],
          "watermark": {
            "allowWaterMark": true
          }
        },
        "screens": {
          "loadingScreen": {},
          "instructionScreen": {}
        },
        "appearance": {
          "theme": {
            "type": "light",
            "configuration": {
              "theme": "light",
              "iconColor": "#DA0E64",
              "primaryColor": "#DA0E64",
              "selectionColor": "#FFF5FC"
            }
          },
          "typography": {
            "font": "Inter"
          }
        },
        "customCode": {}
      },
      "meta": {},
      "domains": [],
      "created_at": "2026-01-05T09:56:54.691Z",
      "updated_at": "2026-01-05T09:56:54.691Z"
    }
  }
}