Reset a conversion report and re-enqueue it for delivery (ADMIN)

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

reportId

required

string

Responses

200

{ ok: true, report }. Some keys are dynamic — 200 body is {ok: true, report: } — i.e. status is always “PENDING”, errorMessage null, retryCount 0 in the returned record. Error responses: 404 {error:“记录不存在”}; 503 {error:“队列不可用，已重置状态”} when the queue send throws (the DB reset has already happened). requestPayload / responsePayload are opaque JSON blobs persisted from the last provider attempt — genuinely dynamic per ad platform, kept permissive. Sampled providers redact secrets (e.g. tencent-gdt writes sign: “[REDACTED]”), but these blobs echo outbound request bodies, so they are audit data rather than a stable schema. They are optional in the TS type but mapRow always assigns them (value may be null). createdAt/updatedAt/eventTimestamp go through normalizeUtcTimestamp (ISO-8601 UTC); eventTimestamp may be null. amount is stored in minor units (cents) per project convention.

Media typeapplication/json

object

ok

required

boolean

report

required

object

id

required

string

projectId

required

string

eventType

required

string

platform

required

string

Allowed values: BAIDU DOUYIN TENCENT KUAISHOU XIAOHONGSHU BILIBILI WEIBO GOOGLE META TIKTOK BING TWITTER LINKEDIN SNAPCHAT PINTEREST KWAI GOOGLE_MEASUREMENT BIGO TRAFFICSTARS TRAFFICJUNKY PROPELLERADS DEEPCLICK MGSKY ADJUST XIAOBU OKSPIN SNAPTUBE APPLUCK MACAN

platformEventType

required

string

nullable

standardEventCode

required

string

nullable

status

required

Always “PENDING” in this response (record was just reset).

string

Allowed values: PENDING SUCCESS FAILED DEAD_LETTER

errorMessage

required

Always null here.

string

nullable

retryCount

required

Always 0 here.

integer

createdAt

required

ISO-8601 UTC timestamp.

string

updatedAt

required

ISO-8601 UTC timestamp.

string

eventTimestamp

required

ISO-8601 UTC timestamp.

string

nullable

visitorId

required

string

nullable

userId

required

string

nullable

clickId

required

Mapped from the DB column clickIdUsed.

string

nullable

matchMethod

required

string

nullable

landingUrl

required

string

nullable

amount

required

Minor units (cents) per project convention.

integer

nullable

currency

required

string

nullable

shortLinkId

required

string

nullable

adPlatformConfigId

required

string

nullable

shortLink

required

object

id

required

string

name

required

string

nullable

shortCode

required

string

adPlatformConfig

required

object

id

required

string

name

required

string

platform

required

string

Allowed values: BAIDU DOUYIN TENCENT KUAISHOU XIAOHONGSHU BILIBILI WEIBO GOOGLE META TIKTOK BING TWITTER LINKEDIN SNAPCHAT PINTEREST KWAI GOOGLE_MEASUREMENT BIGO TRAFFICSTARS TRAFFICJUNKY PROPELLERADS DEEPCLICK MGSKY ADJUST XIAOBU OKSPIN SNAPTUBE APPLUCK MACAN

visit

required

object

id

required

Empty string when visitId is null but other visit fields exist.

string

landingUrl

required

string

nullable

visitorId

required

string

nullable

clickIds

required

object

key

additional properties

string

requestPayload

Opaque provider request payload from the last attempt. DYNAMIC per ad platform — intentionally unconstrained.

nullable

responsePayload

Opaque provider response payload from the last attempt. DYNAMIC per ad platform — intentionally unconstrained.

nullable

404

Report not found

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

503

Conversion queue unavailable (status was reset)

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}