cURL

curl -X POST https://api.clickterm.com/public-client/v1/clickwraps/re-accept \
  -H "X-APP-ID: YOUR_APP_ID" \
  -H "X-APP-KEY: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "endUserIds": ["user-123", "user-456"],
        "clickwrapTemplateIds": ["987e6543-e21b-45d3-b321-426614174999"],
        "reason": "user_updated_profile"
      }'

const response = await fetch(
  "https://api.clickterm.com/public-client/v1/clickwraps/re-accept",
  {
    method: "POST",
    headers: {
      "X-APP-ID": process.env.CLICKTERM_APP_ID,
      "X-APP-KEY": process.env.CLICKTERM_APP_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      endUserIds: ["user-123", "user-456"],
      clickwrapTemplateIds: ["987e6543-e21b-45d3-b321-426614174999"],
      reason: "user_updated_profile",
    }),
  }
);
const result = await response.json();

response = requests.post(
    "https://api.clickterm.com/public-client/v1/clickwraps/re-accept",
    headers={
        "X-APP-ID": CLICKTERM_APP_ID,
        "X-APP-KEY": CLICKTERM_APP_KEY,
        "Content-Type": "application/json",
    },
    json={
        "endUserIds": ["user-123", "user-456"],
        "clickwrapTemplateIds": ["987e6543-e21b-45d3-b321-426614174999"],
        "reason": "user_updated_profile",
    },
)
result = response.json()

HttpResponse<String> response = Unirest.post(
    "https://api.clickterm.com/public-client/v1/clickwraps/re-accept")
  .header("X-APP-ID", "YOUR_APP_ID")
  .header("X-APP-KEY", "YOUR_APP_KEY")
  .header("Content-Type", "application/json")
  .body("{\"endUserIds\":[\"user-123\"],\"clickwrapTemplateIds\":[\"987e6543-e21b-45d3-b321-426614174999\"],\"reason\":\"user_updated_profile\"}")
  .asString();

{
  "results": [
    {
      "endUserId": "user-123",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "status": "re_accept_requested"
    },
    {
      "endUserId": "user-456",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "status": "skipped",
      "reason": "no_prior_acceptance"
    }
  ],
  "summary": {
    "re_accept_requested": 1,
    "skipped": 1
  }
}

{
  "error": "resource_not_found",
  "missingEndUserIds": [
    "user-bogus-99"
  ],
  "missingClickwrapTemplateIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Request clickwrap re-acceptance

Marks one or more end users’ prior clickwrap acceptances as stale so the SDK re-displays the clickwrap on their next GET /clickwrap, prompting them to sign again against the current template content and placeholder values.

Typically called from your backend’s profile-update handler when details that were filled into the agreement change (such as the user’s name, address, or company). ClickTerm does not detect these changes for you - you decide when a re-acceptance is needed.

The set of pairs evaluated is the cartesian product of endUserIds × clickwrapTemplateIds. Each pair is evaluated independently and produces exactly one entry in results.

The user’s previous acceptance event remains valid and binding - it is never invalidated, so there is no compliance gap. The consent status endpoint keeps reporting status: ACCEPTED based on that event; the new reAcceptanceRequired field is simply an extra signal that the clickwrap should be shown again so the user can re-accept.

Authenticated - requires X-APP-ID and X-APP-KEY headers. All resolution is scoped to the calling app.

POST

clickwraps

re-accept

cURL

curl -X POST https://api.clickterm.com/public-client/v1/clickwraps/re-accept \
  -H "X-APP-ID: YOUR_APP_ID" \
  -H "X-APP-KEY: YOUR_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "endUserIds": ["user-123", "user-456"],
        "clickwrapTemplateIds": ["987e6543-e21b-45d3-b321-426614174999"],
        "reason": "user_updated_profile"
      }'

const response = await fetch(
  "https://api.clickterm.com/public-client/v1/clickwraps/re-accept",
  {
    method: "POST",
    headers: {
      "X-APP-ID": process.env.CLICKTERM_APP_ID,
      "X-APP-KEY": process.env.CLICKTERM_APP_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      endUserIds: ["user-123", "user-456"],
      clickwrapTemplateIds: ["987e6543-e21b-45d3-b321-426614174999"],
      reason: "user_updated_profile",
    }),
  }
);
const result = await response.json();

response = requests.post(
    "https://api.clickterm.com/public-client/v1/clickwraps/re-accept",
    headers={
        "X-APP-ID": CLICKTERM_APP_ID,
        "X-APP-KEY": CLICKTERM_APP_KEY,
        "Content-Type": "application/json",
    },
    json={
        "endUserIds": ["user-123", "user-456"],
        "clickwrapTemplateIds": ["987e6543-e21b-45d3-b321-426614174999"],
        "reason": "user_updated_profile",
    },
)
result = response.json()

HttpResponse<String> response = Unirest.post(
    "https://api.clickterm.com/public-client/v1/clickwraps/re-accept")
  .header("X-APP-ID", "YOUR_APP_ID")
  .header("X-APP-KEY", "YOUR_APP_KEY")
  .header("Content-Type", "application/json")
  .body("{\"endUserIds\":[\"user-123\"],\"clickwrapTemplateIds\":[\"987e6543-e21b-45d3-b321-426614174999\"],\"reason\":\"user_updated_profile\"}")
  .asString();

{
  "results": [
    {
      "endUserId": "user-123",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "status": "re_accept_requested"
    },
    {
      "endUserId": "user-456",
      "clickwrapTemplateId": "987e6543-e21b-45d3-b321-426614174999",
      "status": "skipped",
      "reason": "no_prior_acceptance"
    }
  ],
  "summary": {
    "re_accept_requested": 1,
    "skipped": 1
  }
}

{
  "error": "resource_not_found",
  "missingEndUserIds": [
    "user-bogus-99"
  ],
  "missingClickwrapTemplateIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Authorizations

X-APP-ID

string

header

required

Your application's App ID, sent as the X-APP-ID header. Must be accompanied by X-APP-KEY for authenticated endpoints.

X-APP-KEY

string

header

required

Your application's secret App Key (server-side only)

Body

application/json

Identifies which end users and templates to mark for re-acceptance

endUserIds

string[]

required

External end-user identifiers (your own IDs). Each is resolved under the calling app. Must be non-empty.

Minimum array length: 1

clickwrapTemplateIds

string<uuid>[]

required

Clickwrap template IDs to mark for re-acceptance. Each is resolved under the calling app. Must be non-empty.

Minimum array length: 1

reason

string | null

Optional free-text note stored for audit. Max 500 characters.

Maximum string length: 500

Response

Per end-user/template-pair re-acceptance outcomes

Outcome of a re-acceptance request, one entry per end-user/template pair

results

object[]

One entry per (endUserId, clickwrapTemplateId) pair

Show child attributes

summary

object

Count of pairs by status value, e.g. { "re_accept_requested": 1, "skipped": 2 }.

Show child attributes

Get consent status for end user Get templates by tags