People & IdentityList merge warnings

List merge warnings

Merge warnings for the location — conflicting identity signals the processor flagged but did not act on. Use watermark pagination with since and the returned next_since.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/data/merge-warnings?location_id=acme-retail&since=2024-12-25T10%3A00%3A00Z&limit=500" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "source_person_id": "example_string",
      "target_person_id": "example_string",
      "event_name": "John Doe",
      "event_distinct_id": "example_string",
      "identity_value": "example_string",
      "reason": "example_string",
      "created_at": "2024-12-25T10:00:00Z"
    }
  ],
  "rows": 500,
  "next_since": "2024-12-25T10:00:00Z"
}
GET
/merge-warnings
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.

Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.
Bearer Token
Bearer Tokenstring
Required

Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.

Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.
query
location_idstring

Required for agency (ak_) keys. Ignored for secret (sk_) keys, which resolve their own location. May also be supplied via the X-Location-Id header.

query
sincestring

Return only warnings created after this timestamp. Pass the previous page's next_since.

Format: date-time
query
limitinteger

Maximum warnings per page. Default 500, min 1, max 5000.

Min: 1 • Max: 5000
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Agency key as bearer token. Format: Bearer ak_.... Must name a location via the location_id query parameter or X-Location-Id header. Scoped keys (mcp_) are accepted too and need people:read. See Using an mcp_ key over HTTP.

header
Authorizationstring
Required

Bearer token. Location secret key as bearer token. Format: Bearer sk_.... Resolves its own location — no location_id needed.

Query Parameters

location_idstring

Required for agency (ak_) keys. Ignored for secret (sk_) keys, which resolve their own location. May also be supplied via the X-Location-Id header.

Example:
acme-retail
sincestring

Return only warnings created after this timestamp. Pass the previous page's next_since.

limitinteger

Maximum warnings per page. Default 500, min 1, max 5000.

Responses

successboolean
dataarray
rowsinteger
next_sincestring

Watermark for the next page. null when the page is empty.