Sync Checkpoint Validator

integration.sync_checkpoint_validate

ProductionBounded custom (Class B)Deterministicstrictinstantv1.0.0

No network

Overview

You send a checkpoint with version, sourceId, cursorType OFFSET TIMESTAMP or OPAQUE, cursor, issuedAt and optional watermark and partitionCursors. Optional expectedSourceId, expectedVersion, expectedCursorType and an explicit now check expiry without a wall clock. secretCursor defaults to false; the cursor is fingerprinted, never echoed. This does not contact a source or advance the cursor.

A checkpoint from the wrong source silently skips or duplicates a sync.

Reliability

Deterministic checks; now is caller-supplied. CHECKPOINT_INVALID — trigger: a malformed instant or missing version; retryable: no; next: send ISO-8601 instants.

Context footprint

Fingerprint and diagnostics only. A successful call costs 1 execution credit.

When to use it

When a portable checkpoint must be checked before the next incremental pull.

When you need to contact the source or advance the cursor.

Scope

Note

Validates a portable incremental-sync checkpoint without contacting the source.

Non-goals

Does not contact a source
Does not advance a cursor
Does not read a wall clock

Properties

IdempotentRetry safeStreaming supportedFile input supportedRequires external service

Capabilities

validation

Cost & billing

Flat rate per invocation

MetercallsBillable onsuccessCost per call1 credit

File handling

Accepts file_refProduces file_refMax input2 MB

How we handle your data

Sensitive input, safe output

What this means

This skill may receive sensitive content, but it does not target sensitive data and returns only a structured non-sensitive result.

Squillify guarantees

Runs inside Squillify
This skill runs inside Squillify.
Payloads are not sent to an external service by this skill.
Squillify does not permanently store submitted payloads.
Telemetry records metadata only, not submitted content.
Submitted payloads are not used for training.
Submitted payloads are not reviewed by humans.
This skill does not target sensitive data.
The response does not contain submitted content.

Your responsibility

Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.

Read the Microskill Data Handling Policy

Input schema

Field	Type	Required	Description
checkpoint	object	Yes	Closed portable checkpoint with version, source, cursor type, cursor, issuedAt and optional watermarks.
expectedSourceId	string	No	Optional expected source id. Omit it to skip.
expectedVersion	integer	No	Optional minimum version. Omit it to skip.
expectedCursorType	string	No	Optional expected cursor type. Omit it to skip.
now	string	No	Optional ISO-8601 now. Omit it to skip future checks.
secretCursor	boolean	No	Whether the cursor is secret. Omit it for false.

Output schema

Field	Type	Required	Description
valid	boolean	Yes	True when no ERROR diagnostic was raised.
secretCursor	boolean	Yes	Whether the cursor was treated as secret.
checkpoint	object	Yes	Closed normalized checkpoint metadata with a cursor fingerprint and no raw cursor.
diagnostics	array	Yes	Bounded array of 0 through 500 closed findings, each with code, severity, message, path, source and details.

API contract

POST /v1/execute

curl

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"integration.sync_checkpoint_validate","input":{"checkpoint":{"version":1,"sourceId":"crm","cursorType":"OFFSET","cursor":"1","issuedAt":"2026-08-27T00:00:00Z"}}}'

Integrations

TypeScript SDK

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("integration.sync_checkpoint_validate", {"checkpoint":{"cursor":"100","sourceId":"crm","cursorType":"OFFSET","issuedAt":"2026-08-27T00:00:00Z","version":1}});

Errors

Code	HTTP	Retryable	Description
VALIDATION_ERROR	400	No	The request payload failed schema validation.
UNAUTHORIZED	401	No	Missing or invalid API key.
SKILL_NOT_ACCESSIBLE	403	No	The API key is not granted access to this skill.
SKILL_NOT_AVAILABLE_FOR_PLAN	403	No	This skill is not included in your current plan.
PLAN_ELIGIBILITY_UNAVAILABLE	503	Yes	Plan eligibility could not be decided. Retry after backoff.
SKILL_NOT_FOUND	404	No	The requested skill or version does not exist.
TENANT_RATE_LIMITED	429	Yes	Request rate limit exceeded. Retry after backoff.
QUOTA_EXCEEDED	429	Yes	Plan quota exhausted. Retryable once the quota period resets.
EXECUTION_TIMEOUT	504	Yes	Execution exceeded the allowed time budget.
CHECKPOINT_INVALID	400	No	The request payload failed this skill's input validation.

Other limits

Limit	Value
Recommended inline bytes	32 KiB

Limitations

Does not contact a source
Does not advance a cursor
Does not read a wall clock
Fetching the next page
Storing the checkpoint

How to call

POST /v1/execute (requires authentication)

Request bodyjson

{
  "skillKey": "integration.sync_checkpoint_validate",
  "input": {
    "checkpoint": {
      "cursor": "100",
      "sourceId": "crm",
      "cursorType": "OFFSET",
      "issuedAt": "2026-08-27T00:00:00Z",
      "version": 1
    }
  }
}

Examples

A matching OFFSET checkpoint is valid

Inputjson

{
  "checkpoint": {
    "cursor": "100",
    "sourceId": "crm",
    "cursorType": "OFFSET",
    "issuedAt": "2026-08-27T00:00:00Z",
    "version": 1
  }
}

Expected outputjson

{
  "valid": true,
  "diagnostics": [],
  "secretCursor": false,
  "checkpoint": {
    "version": 1,
    "sourceId": "crm",
    "cursorType": "OFFSET",
    "issuedAt": "2026-08-27T00:00:00Z",
    "cursorFingerprint": "ad5736686512"
  }
}

Tip

The cursor is fingerprinted and valid is true.

expectedSourceId mismatch is invalid