{
  "info": {
    "_postman_id": "f7eeac33-6b44-4bb3-9dc5-d832ebab201e",
    "name": "Clerk Backend Account Portal Proxy Checks API",
    "description": "The Clerk REST Backend API, meant to be accessed by backend servers.\n\n### Versions\n\nWhen the API changes in a way that isn't compatible with older versions, a new version is released.\nEach version is identified by its release date, e.g. `2025-04-10`. For more information, please see [Clerk API Versions](https://clerk.com/docs/versioning/available-versions).\n\nPlease see https://clerk.com/docs for more information.\n\nContact Support:\n Name: Clerk Platform Team\n Email: support@clerk.com",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-07-28T01:24:48.000Z",
    "updatedAt": "2026-07-28T01:24:48.000Z",
    "lastUpdatedBy": "35240",
    "uid": "35240-f7eeac33-6b44-4bb3-9dc5-d832ebab201e"
  },
  "item": [
    {
      "name": "proxy_checks",
      "item": [
        {
          "name": "Verify the Proxy Configuration for Your Domain",
          "id": "bb5ad34a-ecc2-463c-a4ea-8038730a7817",
          "protocolProfileBehavior": {
            "disableBodyPruning": true
          },
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"domain_id\": \"<string>\",\n  \"proxy_url\": \"<string>\"\n}",
              "options": {
                "raw": {
                  "headerFamily": "json",
                  "language": "json"
                }
              }
            },
            "url": {
              "raw": "{{baseUrl}}/proxy_checks",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "proxy_checks"
              ]
            },
            "description": "This endpoint can be used to validate that a proxy-enabled domain is operational.\nIt tries to verify that the proxy URL provided in the parameters maps to a functional proxy that can reach the Clerk Frontend API.\n\nYou can use this endpoint before you set a proxy URL for a domain. This way you can ensure that switching to proxy-based\nconfiguration will not lead to downtime for your instance.\n\nThe `proxy_url` parameter allows for testing proxy configurations for domains that don't have a proxy URL yet, or operate on\na different proxy URL than the one provided. It can also be used to re-validate a domain that is already configured to work with a proxy."
          },
          "response": [
            {
              "id": "2c5f11f0-cbe5-4c55-aab7-22675f0b3c67",
              "name": "Health check information about a domain's proxy configuration validation attempt.",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: bearer",
                    "key": "Authorization",
                    "value": "Bearer <token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"domain_id\": \"<string>\",\n  \"proxy_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/proxy_checks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "proxy_checks"
                  ]
                }
              },
              "status": "OK",
              "code": 200,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"object\": \"proxy_check\",\n  \"id\": \"<string>\",\n  \"domain_id\": \"<string>\",\n  \"last_run_at\": \"<long>\",\n  \"proxy_url\": \"<string>\",\n  \"successful\": \"<boolean>\",\n  \"created_at\": \"<long>\",\n  \"updated_at\": \"<long>\"\n}",
              "createdAt": "2026-07-28T01:24:48.000Z",
              "updatedAt": "2026-07-28T01:24:48.000Z",
              "uid": "35240-2c5f11f0-cbe5-4c55-aab7-22675f0b3c67"
            },
            {
              "id": "6284c1a0-6aa4-403b-aeb2-d41b60e2096f",
              "name": "Request was not successful",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: bearer",
                    "key": "Authorization",
                    "value": "Bearer <token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"domain_id\": \"<string>\",\n  \"proxy_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/proxy_checks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "proxy_checks"
                  ]
                }
              },
              "status": "Bad Request",
              "code": 400,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"errors\": [\n    {\n      \"message\": \"<string>\",\n      \"long_message\": \"<string>\",\n      \"code\": \"<string>\",\n      \"meta\": {}\n    },\n    {\n      \"message\": \"<string>\",\n      \"long_message\": \"<string>\",\n      \"code\": \"<string>\",\n      \"meta\": {}\n    }\n  ],\n  \"meta\": {},\n  \"clerk_trace_id\": \"<string>\"\n}",
              "createdAt": "2026-07-28T01:24:48.000Z",
              "updatedAt": "2026-07-28T01:24:48.000Z",
              "uid": "35240-6284c1a0-6aa4-403b-aeb2-d41b60e2096f"
            },
            {
              "id": "f8f7f8e4-2346-46bf-85d8-685b18b403f4",
              "name": "Invalid request parameters",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "Accept",
                    "value": "application/json"
                  },
                  {
                    "description": "Added as a part of security scheme: bearer",
                    "key": "Authorization",
                    "value": "Bearer <token>"
                  }
                ],
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"domain_id\": \"<string>\",\n  \"proxy_url\": \"<string>\"\n}",
                  "options": {
                    "raw": {
                      "headerFamily": "json",
                      "language": "json"
                    }
                  }
                },
                "url": {
                  "raw": "{{baseUrl}}/proxy_checks",
                  "host": [
                    "{{baseUrl}}"
                  ],
                  "path": [
                    "proxy_checks"
                  ]
                }
              },
              "status": "Unprocessable Entity (WebDAV) (RFC 4918)",
              "code": 422,
              "_postman_previewlanguage": "json",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "cookie": [],
              "responseTime": null,
              "body": "{\n  \"errors\": [\n    {\n      \"message\": \"<string>\",\n      \"long_message\": \"<string>\",\n      \"code\": \"<string>\",\n      \"meta\": {}\n    },\n    {\n      \"message\": \"<string>\",\n      \"long_message\": \"<string>\",\n      \"code\": \"<string>\",\n      \"meta\": {}\n    }\n  ],\n  \"meta\": {},\n  \"clerk_trace_id\": \"<string>\"\n}",
              "createdAt": "2026-07-28T01:24:48.000Z",
              "updatedAt": "2026-07-28T01:24:48.000Z",
              "uid": "35240-f8f7f8e4-2346-46bf-85d8-685b18b403f4"
            }
          ],
          "createdAt": "2026-07-28T01:24:48.000Z",
          "updatedAt": "2026-07-28T01:24:48.000Z",
          "uid": "35240-bb5ad34a-ecc2-463c-a4ea-8038730a7817"
        }
      ],
      "id": "d7f4c4f7-1011-417e-a359-5651e239fe75",
      "createdAt": "2026-07-28T01:24:48.000Z",
      "updatedAt": "2026-07-28T01:24:48.000Z",
      "uid": "35240-d7f4c4f7-1011-417e-a359-5651e239fe75"
    }
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{bearerToken}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.clerk.com/v1"
    }
  ]
}