Queue a complete exact or fuzzy target-wide scan owned by the current actor.
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Post, RequestUri = new Uri("https://example.com/api/workspace/entity/example/record-matching/full-scans"), Content = new StringContent("{ \"ProfileId\": \"example\", \"ArchiveMode\": 0, \"IdempotencyKey\": \"example\" }") { Headers = { ContentType = new MediaTypeHeaderValue("application/json") } }};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://example.com/api/workspace/entity/example/record-matching/full-scans';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"ProfileId":"example","ArchiveMode":0,"IdempotencyKey":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/workspace/entity/example/record-matching/full-scans \ --header 'Content-Type: application/json' \ --data '{ "ProfileId": "example", "ArchiveMode": 0, "IdempotencyKey": "example" }'The HTTP request never performs the scan. The Worker Host persists progress and a bounded, actor-owned result. Reusing an idempotency key with a different request, submitting an unsupported profile, or attempting to start a duplicate active scan returns HTTP 409. A disabled full-scan worker returns HTTP 503. The response never exposes another actor’s job or result identifiers.
Authorizations
Section titled “Authorizations”- None
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Target entity definition identifier or key.
Query Parameters
Section titled “Query Parameters”Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.
Request Body
Section titled “Request Body”Profile, archive scope, and idempotency key for the durable scan.
Request payload for one durable Worker-owned complete target-wide scan.
object
Enabled Table Page profile to pin for the scan.
Caller-generated key used to deduplicate equivalent enqueue attempts.
Request payload for one durable Worker-owned complete target-wide scan.
object
Enabled Table Page profile to pin for the scan.
Caller-generated key used to deduplicate equivalent enqueue attempts.
Request payload for one durable Worker-owned complete target-wide scan.
object
Enabled Table Page profile to pin for the scan.
Caller-generated key used to deduplicate equivalent enqueue attempts.
Responses
Section titled “Responses”Accepted
object
Status and actor-owned progress of one durable full target-wide matching scan.
object
Stable persisted job identifier.
Compact record-matching profile used by lists and launch options.
object
Complete actor-visible count after the Worker has counted the scope.
Records streamed through the complete scan.
Complete persisted group count after success.
Distinct persisted candidate count after success.
Number of fenced Worker attempts.
Whether the current actor may request cancellation.
Whether the current actor may enqueue a retry.
Stable localized error code for a terminal failure.
Localized terminal failure message.
Job creation time.
First processing time, when claimed.
Terminal completion time.
Time at which the currently published result snapshot was captured.
Whether the terminal failure was classified as transient for automatic retry diagnostics.
One bounded page over the complete persisted groups of a successful full scan.
object
Transient result of a record-matching run. For Details Page anchored matching, TotalScannedRecords equals TotalVisibleRecords and ScanLimitReached is false; target-wide scans remain bounded and may be partial.
object
Compact record-matching profile used by lists and launch options.
object
Visible record candidate returned by the matching engine.
object
object
object
Complete actor-visible record count in the selected archive scope.
Records covered by the matching run.
Whether a target-wide scan stopped at its request limit.
Complete groups for anchored runs, or groups from the bounded target-wide scan.
One exact set or honest fuzzy pair produced by matching rules.
object
Stable group identifier derived from its canonical candidate set.
Highest effective exact or fuzzy rule score contributing to the group.
Rules that produced the exact set or canonical fuzzy pair.
Configured rule that contributed to a candidate group. Score is the effective score; ConfiguredScore preserves the profile score before fuzzy similarity.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Effective score after fuzzy similarity is applied.
Configured rule score before fuzzy similarity; null for legacy exact results.
Weighted similarity from zero through ten thousand basis points.
Readable matching-field reasons for the group.
Actor-safe field evidence for an exact-normalized match or fuzzy comparison. Fuzzy evidence exposes distance and settings but never raw or normalized matching values.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Stable matching field identifier.
Portable technical entity-field key.
Current actor-readable field label.
Actor-safe exact diagnostic; empty for fuzzy evidence.
Unicode-rune edit distance, or null for exact evidence.
Configured inclusive fuzzy threshold, or null for exact evidence.
Field similarity from zero through ten thousand basis points.
Configured fuzzy field weight, or null for exact evidence.
Candidates materialized in the current bounded response page.
Visible record candidate returned by the matching engine.
object
object
object
Complete candidate count when candidates are paged; otherwise null.
One-based group page.
Applied bounded group page size.
Complete group count in the saved result.
object
object
object
object
Example
{ "Data": { "Status": 0, "Phase": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "ArchiveMode": 0, "Result": { "Run": { "Surface": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "Groups": [ { "ConfidenceBand": 0, "Reasons": [ { "Normalizer": 0, "ComparisonMode": 0, "FuzzyAlgorithm": 0, "DiacriticMode": 0, "TokenOrderMode": 0 } ], "GroupKind": 0 } ] } } }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Forbidden
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Not Found
object
Status and actor-owned progress of one durable full target-wide matching scan.
object
Stable persisted job identifier.
Compact record-matching profile used by lists and launch options.
object
Complete actor-visible count after the Worker has counted the scope.
Records streamed through the complete scan.
Complete persisted group count after success.
Distinct persisted candidate count after success.
Number of fenced Worker attempts.
Whether the current actor may request cancellation.
Whether the current actor may enqueue a retry.
Stable localized error code for a terminal failure.
Localized terminal failure message.
Job creation time.
First processing time, when claimed.
Terminal completion time.
Time at which the currently published result snapshot was captured.
Whether the terminal failure was classified as transient for automatic retry diagnostics.
One bounded page over the complete persisted groups of a successful full scan.
object
Transient result of a record-matching run. For Details Page anchored matching, TotalScannedRecords equals TotalVisibleRecords and ScanLimitReached is false; target-wide scans remain bounded and may be partial.
object
Compact record-matching profile used by lists and launch options.
object
Visible record candidate returned by the matching engine.
object
object
object
Complete actor-visible record count in the selected archive scope.
Records covered by the matching run.
Whether a target-wide scan stopped at its request limit.
Complete groups for anchored runs, or groups from the bounded target-wide scan.
One exact set or honest fuzzy pair produced by matching rules.
object
Stable group identifier derived from its canonical candidate set.
Highest effective exact or fuzzy rule score contributing to the group.
Rules that produced the exact set or canonical fuzzy pair.
Configured rule that contributed to a candidate group. Score is the effective score; ConfiguredScore preserves the profile score before fuzzy similarity.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Effective score after fuzzy similarity is applied.
Configured rule score before fuzzy similarity; null for legacy exact results.
Weighted similarity from zero through ten thousand basis points.
Readable matching-field reasons for the group.
Actor-safe field evidence for an exact-normalized match or fuzzy comparison. Fuzzy evidence exposes distance and settings but never raw or normalized matching values.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Stable matching field identifier.
Portable technical entity-field key.
Current actor-readable field label.
Actor-safe exact diagnostic; empty for fuzzy evidence.
Unicode-rune edit distance, or null for exact evidence.
Configured inclusive fuzzy threshold, or null for exact evidence.
Field similarity from zero through ten thousand basis points.
Configured fuzzy field weight, or null for exact evidence.
Candidates materialized in the current bounded response page.
Visible record candidate returned by the matching engine.
object
object
object
Complete candidate count when candidates are paged; otherwise null.
One-based group page.
Applied bounded group page size.
Complete group count in the saved result.
object
object
object
object
Example
{ "Data": { "Status": 0, "Phase": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "ArchiveMode": 0, "Result": { "Run": { "Surface": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "Groups": [ { "ConfidenceBand": 0, "Reasons": [ { "Normalizer": 0, "ComparisonMode": 0, "FuzzyAlgorithm": 0, "DiacriticMode": 0, "TokenOrderMode": 0 } ], "GroupKind": 0 } ] } } }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Conflict
object
Status and actor-owned progress of one durable full target-wide matching scan.
object
Stable persisted job identifier.
Compact record-matching profile used by lists and launch options.
object
Complete actor-visible count after the Worker has counted the scope.
Records streamed through the complete scan.
Complete persisted group count after success.
Distinct persisted candidate count after success.
Number of fenced Worker attempts.
Whether the current actor may request cancellation.
Whether the current actor may enqueue a retry.
Stable localized error code for a terminal failure.
Localized terminal failure message.
Job creation time.
First processing time, when claimed.
Terminal completion time.
Time at which the currently published result snapshot was captured.
Whether the terminal failure was classified as transient for automatic retry diagnostics.
One bounded page over the complete persisted groups of a successful full scan.
object
Transient result of a record-matching run. For Details Page anchored matching, TotalScannedRecords equals TotalVisibleRecords and ScanLimitReached is false; target-wide scans remain bounded and may be partial.
object
Compact record-matching profile used by lists and launch options.
object
Visible record candidate returned by the matching engine.
object
object
object
Complete actor-visible record count in the selected archive scope.
Records covered by the matching run.
Whether a target-wide scan stopped at its request limit.
Complete groups for anchored runs, or groups from the bounded target-wide scan.
One exact set or honest fuzzy pair produced by matching rules.
object
Stable group identifier derived from its canonical candidate set.
Highest effective exact or fuzzy rule score contributing to the group.
Rules that produced the exact set or canonical fuzzy pair.
Configured rule that contributed to a candidate group. Score is the effective score; ConfiguredScore preserves the profile score before fuzzy similarity.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Effective score after fuzzy similarity is applied.
Configured rule score before fuzzy similarity; null for legacy exact results.
Weighted similarity from zero through ten thousand basis points.
Readable matching-field reasons for the group.
Actor-safe field evidence for an exact-normalized match or fuzzy comparison. Fuzzy evidence exposes distance and settings but never raw or normalized matching values.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Stable matching field identifier.
Portable technical entity-field key.
Current actor-readable field label.
Actor-safe exact diagnostic; empty for fuzzy evidence.
Unicode-rune edit distance, or null for exact evidence.
Configured inclusive fuzzy threshold, or null for exact evidence.
Field similarity from zero through ten thousand basis points.
Configured fuzzy field weight, or null for exact evidence.
Candidates materialized in the current bounded response page.
Visible record candidate returned by the matching engine.
object
object
object
Complete candidate count when candidates are paged; otherwise null.
One-based group page.
Applied bounded group page size.
Complete group count in the saved result.
object
object
object
object
Example
{ "Data": { "Status": 0, "Phase": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "ArchiveMode": 0, "Result": { "Run": { "Surface": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "Groups": [ { "ConfidenceBand": 0, "Reasons": [ { "Normalizer": 0, "ComparisonMode": 0, "FuzzyAlgorithm": 0, "DiacriticMode": 0, "TokenOrderMode": 0 } ], "GroupKind": 0 } ] } } }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}Service Unavailable
object
Status and actor-owned progress of one durable full target-wide matching scan.
object
Stable persisted job identifier.
Compact record-matching profile used by lists and launch options.
object
Complete actor-visible count after the Worker has counted the scope.
Records streamed through the complete scan.
Complete persisted group count after success.
Distinct persisted candidate count after success.
Number of fenced Worker attempts.
Whether the current actor may request cancellation.
Whether the current actor may enqueue a retry.
Stable localized error code for a terminal failure.
Localized terminal failure message.
Job creation time.
First processing time, when claimed.
Terminal completion time.
Time at which the currently published result snapshot was captured.
Whether the terminal failure was classified as transient for automatic retry diagnostics.
One bounded page over the complete persisted groups of a successful full scan.
object
Transient result of a record-matching run. For Details Page anchored matching, TotalScannedRecords equals TotalVisibleRecords and ScanLimitReached is false; target-wide scans remain bounded and may be partial.
object
Compact record-matching profile used by lists and launch options.
object
Visible record candidate returned by the matching engine.
object
object
object
Complete actor-visible record count in the selected archive scope.
Records covered by the matching run.
Whether a target-wide scan stopped at its request limit.
Complete groups for anchored runs, or groups from the bounded target-wide scan.
One exact set or honest fuzzy pair produced by matching rules.
object
Stable group identifier derived from its canonical candidate set.
Highest effective exact or fuzzy rule score contributing to the group.
Rules that produced the exact set or canonical fuzzy pair.
Configured rule that contributed to a candidate group. Score is the effective score; ConfiguredScore preserves the profile score before fuzzy similarity.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Effective score after fuzzy similarity is applied.
Configured rule score before fuzzy similarity; null for legacy exact results.
Weighted similarity from zero through ten thousand basis points.
Readable matching-field reasons for the group.
Actor-safe field evidence for an exact-normalized match or fuzzy comparison. Fuzzy evidence exposes distance and settings but never raw or normalized matching values.
object
Stable matching-rule identifier.
Portable technical rule key.
Current rule label.
Stable matching field identifier.
Portable technical entity-field key.
Current actor-readable field label.
Actor-safe exact diagnostic; empty for fuzzy evidence.
Unicode-rune edit distance, or null for exact evidence.
Configured inclusive fuzzy threshold, or null for exact evidence.
Field similarity from zero through ten thousand basis points.
Configured fuzzy field weight, or null for exact evidence.
Candidates materialized in the current bounded response page.
Visible record candidate returned by the matching engine.
object
object
object
Complete candidate count when candidates are paged; otherwise null.
One-based group page.
Applied bounded group page size.
Complete group count in the saved result.
object
object
object
object
Example
{ "Data": { "Status": 0, "Phase": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "ArchiveMode": 0, "Result": { "Run": { "Surface": 0, "Profile": { "TargetKind": 0, "ActionMode": 0 }, "Groups": [ { "ConfidenceBand": 0, "Reasons": [ { "Normalizer": 0, "ComparisonMode": 0, "FuzzyAlgorithm": 0, "DiacriticMode": 0, "TokenOrderMode": 0 } ], "GroupKind": 0 } ] } } }, "Errors": [ { "Type": 0, "Severity": 0 } ], "Warnings": [ { "Type": 0, "Severity": 0 } ]}