Updates an app integration recaptcha

Updates an app integration ReCaptcha by the given id.

put

Path parameters

idstringRequired

The app integration ReCaptcha id.

Header parameters

Brand-URLstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

Auth-KeystringRequired

Auth-Key is required to authenticate the request. If missing, the server will return 401 Unauthorized.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

Provides a data transfer object for the ReCaptcha integration which is used for command requests.

appIntegrationIdstring · min: 1Required

This is used to associate this configuration with a specific integration instance.

versionstring · min: 1Required

Gets or sets the version of the ReCaptcha being used (e.g., v2, v3). Different versions may have different behavior and setup requirements.

siteKeystring · min: 1Required

This is the public key used on the client-side to render the ReCaptcha widget.

verifyURLstring · nullableOptional

The verify URL of the app integration.

secretKeystring · nullableOptional

This is the private key used server-side to validate ReCaptcha responses. It's optional to allow scenarios where only public configuration is required.

accountConfigNotesstring · nullableOptional

Gets or sets any additional notes or identifiers related to the account or setup that manages this ReCaptcha configuration.

isDefaultbooleanOptional

Flag to indicate if the analytics integration is the default. By default, it is false.

statusstring · enumOptional

This enum is used to define the common status of an object in JFW.

Supported values:

• Inactive - In case of JFW object's status being inactive.
• Active - In case of JFW object's status being active

Possible values:

Responses

200

The request was successful.

application/json

This provides interfaces for API responses with data.

successbooleanRead-onlyRequired

This is the flag to indicate whether the API call is successful or not.

statusCodeinteger · int32Read-onlyRequired

This is the HTTP status code. This is used to determine the status code to be returned to the client.

messagestring · min: 1Read-onlyRequired

This is the message to be displayed to the user.

401

The user is not authorized to access the requested resource. The request is missing the required Auth-Key header.

application/json

403

The user's access was denied.

application/json

429

API call exceeded rate limit due to too many requests.

application/json

put

/api/v1/app-integrations/recaptcha/{id}

HTTPcURLJavaScriptPython

PUT /api/v1/app-integrations/recaptcha/{id} HTTP/1.1
Host: protocol.jframework.io
Brand-URL: text
Auth-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 164

{
  "appIntegrationId": "text",
  "version": "text",
  "siteKey": "text",
  "verifyURL": "text",
  "secretKey": "text",
  "accountConfigNotes": "text",
  "isDefault": true,
  "status": "Inactive"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 200,
  "message": "The request was successful.",
  "data": {
    "appIntegration": {
      "type": "PaymentGateway",
      "name": "Stripe",
      "domain": "https://stripe.com",
      "description": "Stripe payment gateway",
      "logoURL": null,
      "status": "Active",
      "id": "sApKpllz4sAplsmzha"
    },
    "version": "v1",
    "siteKey": "6Le-YC4rAAAAADx-*************",
    "verifyURL": "VERIFY_URL",
    "secretKey": "SITE_KEY_SECRET",
    "accountConfigNotes": "[e-mail]",
    "isDefault": false,
    "status": "Inactive",
    "id": "sApKpllz4sAplsmzha",
    "createdDate": "2026-01-26T08:03:23.627784+07:00"
  },
  "errors": []
}