## Queue event for async ingest (Beta) **post** `/v1/async/events` Beta. Queue backend events for asynchronous ingestion. This endpoint accepts the same request body as POST /v1/events, writes one SQS message per event, and returns after the events are queued. SafetyKit later processes the queued events through the standard event ingestion path. ### Body Parameters - `body: object { event_name, target_user_id, timestamp, 8 more } or object { content, event_name, timestamp, 7 more } or object { content, event_name, product, 8 more } or 5 more` Backend event or ordered batch of events to send to SafetyKit. Send events from your server after an action has happened in your product. Do not send these events directly from a browser or mobile client. - `UserContactEventRequest object { event_name, target_user_id, timestamp, 8 more }` A user contacts, transacts with, or otherwise interacts with another user. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `target_user_id: string` Your stable canonical identifier for the other user in a user-to-user interaction. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "user_contact"` - `"user_contact"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `ContentUploadedEventRequest object { content, event_name, timestamp, 7 more }` A user posts, uploads, publishes, edits, or replaces content. - `content: array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "content_uploaded"` - `"content_uploaded"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `ProductChangedEventRequest object { content, event_name, product, 8 more }` A product listing is created, updated, or has a discount added. - `content: array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `event_name: "product_created" or "product_updated"` Product action that triggered this event. - `"product_created"` - `"product_updated"` - `product: object { price, discounted_price, shipping_info }` Commerce details for the product involved in this event. - `price: object { amount, currency }` Current listed price of the product. - `amount: string` Price amount as a decimal string. - `currency: string` ISO 4217 currency code. - `discounted_price: optional object { amount, currency }` Discounted price of the product, when a discount applies. - `amount: string` Price amount as a decimal string. - `currency: string` ISO 4217 currency code. - `shipping_info: optional object { ships_from, ships_to }` Shipping details for the product. - `ships_from: string` Location the product ships from. - `ships_to: array of string` Locations the product ships to. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "product_changed"` - `"product_changed"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `CreateAccountEventRequest object { event_name, timestamp, type, 7 more }` A user or account is created. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "create_account"` - `"create_account"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `UpdateAccountEventRequest object { event_name, timestamp, type, 7 more }` A user or account profile, contact detail, payment detail, or public bio changes. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "update_account"` - `"update_account"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `UserReportEventRequest object { event_name, labels, timestamp, 10 more }` A user-submitted report. Use user_id for the reporter. Include target_user_id when a user is reported, target_content_id when content is reported, and both when the report is about content associated with a user. Use content and content_id for the report itself. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `labels: array of string` One or more label categories supplied with the report or moderation decision. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "user_report"` - `"user_report"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `target_content_id: optional string` Your stable identifier for the content being reported. - `target_user_id: optional string` Your stable canonical identifier for the user being reported. - `ModerationDecisionEventRequest object { event_name, labels, source_id, 11 more }` A moderation label or decision from an automated enforcement system or manual review workflow. Do not send user_id; use source_type and source_id for attribution. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `labels: array of string` One or more label categories supplied with the report or moderation decision. - `source_id: string` Stable identifier within source_type. Examples: moderator@example.com or 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator, automated_review_v2026_06_04 for automation, or -v2.1 for vendor. - `source_type: "human_moderator" or "expert_labeler" or "automation" or "vendor"` Coarse attribution category for the moderation decision source. Supported values: human_moderator (a human reviewer in your moderation workflow), expert_labeler (an expert human labeler or specialist reviewer), automation (an automated model, rules engine, or enforcement workflow), or vendor (an external review or moderation provider). - `"human_moderator"` - `"expert_labeler"` - `"automation"` - `"vendor"` - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "moderation_decision"` - `"moderation_decision"` - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `target_content_id: optional string` Your stable identifier for the content being reported. - `target_user_id: optional string` Your stable canonical identifier for the user being reported. - `array of object { event_name, target_user_id, timestamp, 8 more } or object { content, event_name, timestamp, 7 more } or object { content, event_name, product, 8 more } or 4 more` - `UserContact object { event_name, target_user_id, timestamp, 8 more }` A user contacts, transacts with, or otherwise interacts with another user. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `target_user_id: string` Your stable canonical identifier for the other user in a user-to-user interaction. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "user_contact"` - `"user_contact"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `ContentUploaded object { content, event_name, timestamp, 7 more }` A user posts, uploads, publishes, edits, or replaces content. - `content: array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "content_uploaded"` - `"content_uploaded"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `ProductChanged object { content, event_name, product, 8 more }` A product listing is created, updated, or has a discount added. - `content: array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `event_name: "product_created" or "product_updated"` Product action that triggered this event. - `"product_created"` - `"product_updated"` - `product: object { price, discounted_price, shipping_info }` Commerce details for the product involved in this event. - `price: object { amount, currency }` Current listed price of the product. - `amount: string` Price amount as a decimal string. - `currency: string` ISO 4217 currency code. - `discounted_price: optional object { amount, currency }` Discounted price of the product, when a discount applies. - `amount: string` Price amount as a decimal string. - `currency: string` ISO 4217 currency code. - `shipping_info: optional object { ships_from, ships_to }` Shipping details for the product. - `ships_from: string` Location the product ships from. - `ships_to: array of string` Locations the product ships to. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "product_changed"` - `"product_changed"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `CreateAccount object { event_name, timestamp, type, 7 more }` A user or account is created. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "create_account"` - `"create_account"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `UpdateAccount object { event_name, timestamp, type, 7 more }` A user or account profile, contact detail, payment detail, or public bio changes. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "update_account"` - `"update_account"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `UserReport object { event_name, labels, timestamp, 10 more }` A user-submitted report. Use user_id for the reporter. Include target_user_id when a user is reported, target_content_id when content is reported, and both when the report is about content associated with a user. Use content and content_id for the report itself. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `labels: array of string` One or more label categories supplied with the report or moderation decision. - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "user_report"` - `"user_report"` - `user_id: string` Your stable canonical identifier for the user or account. - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `target_content_id: optional string` Your stable identifier for the content being reported. - `target_user_id: optional string` Your stable canonical identifier for the user being reported. - `ModerationDecision object { event_name, labels, source_id, 11 more }` A moderation label or decision from an automated enforcement system or manual review workflow. Do not send user_id; use source_type and source_id for attribution. - `event_name: string` Stable, low-cardinality product action name. Use snake_case and put dynamic values in typed fields, content, resources_used, or metadata. - `labels: array of string` One or more label categories supplied with the report or moderation decision. - `source_id: string` Stable identifier within source_type. Examples: moderator@example.com or 550e8400-e29b-41d4-a716-446655440000 for expert_labeler or human_moderator, automated_review_v2026_06_04 for automation, or -v2.1 for vendor. - `source_type: "human_moderator" or "expert_labeler" or "automation" or "vendor"` Coarse attribution category for the moderation decision source. Supported values: human_moderator (a human reviewer in your moderation workflow), expert_labeler (an expert human labeler or specialist reviewer), automation (an automated model, rules engine, or enforcement workflow), or vendor (an external review or moderation provider). - `"human_moderator"` - `"expert_labeler"` - `"automation"` - `"vendor"` - `timestamp: string` The time the event occurred in your system, as an ISO 8601 datetime string. - `type: "moderation_decision"` - `"moderation_decision"` - `client_info: optional object { ip }` Client context observed by your backend for the user action that triggered the event. - `ip: optional string` IP address observed by your backend for the client that triggered the event. - `content: optional array of object { text, type, key } or object { source, type, key }` User-authored or user-uploaded content parts. Use this for message bodies, bios, listing text, image URLs, and similar content SafetyKit should compare or analyze. - `EventTextContent object { text, type, key }` User-authored text content associated with an event. - `text: string` User-authored text SafetyKit should compare or analyze. - `type: "text"` Text content part. - `"text"` - `key: optional string` Stable field key for this content part. - `EventImageContent object { source, type, key }` User-uploaded image content associated with an event. - `source: object { type, url }` Image source information. - `type: "url"` URL image source. - `"url"` - `url: string` URL of the image SafetyKit should compare or analyze. - `type: "image"` Image content part. - `"image"` - `key: optional string` Stable field key for this content part. - `content_id: optional string` Your stable identifier for the content involved in this event, such as a message, listing, page, post, profile, or uploaded media item. - `idempotency_key: optional string` Optional caller-provided key used to make retries of this individual event idempotent. Reuse the same key only for retries of the same logical event. - `metadata: optional map[string or number or boolean or array of string or number or boolean]` Non-PII product context for filtering, segmentation, and debugging. Values may be strings, numbers, booleans, or arrays of those scalar values. - `string` - `number` - `boolean` - `array of string or number or boolean` - `string` - `number` - `boolean` - `resources_used: optional array of object { namespace, type, value } or object { type, value }` Reusable resources observed during the event. Use this for emails, phone numbers, names, addresses, social handles, URLs, payment identifiers, caller-defined ids, or similar identifiers. - `EntityIDResource object { namespace, type, value }` Caller-defined stable entity identifier resource. This is equivalent to an id resource value of urlEncode(namespace) + '/' + urlEncode(value). - `namespace: string` Caller-defined namespace for the identifier. SafetyKit stores this with value as urlEncode(namespace) + '/' + urlEncode(value). - `type: "id"` Caller-defined entity identifier resource. - `"id"` - `value: string` Identifier value within namespace. SafetyKit stores a normalized hash of the encoded namespace/value pair, not the raw value. - `object { type, value }` Real-world or account resource used during the event, such as an email, phone number, address, URL, social handle, or payment identifier. - `type: string` Resource family, such as email, phone, name, address, url, social handles, payment identifiers, or another stable snake_case identifier. Use the entity ID resource shape when the value belongs to a caller-defined namespace. - `value: string` Resource value used during the event. SafetyKit stores a normalized hash of this value, not the raw value. When type is url, this must be a valid URL. - `target_content_id: optional string` Your stable identifier for the content being reported. - `target_user_id: optional string` Your stable canonical identifier for the user being reported. ### Returns - `queued_events: number` Number of events queued from the request. - `status: "queued"` Events were queued for asynchronous ingestion. - `"queued"` ### Example ```http curl https://api.safetykit.com/v1/async/events \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer $SAFETYKIT_API_KEY" \ -d '{ "event_name": "message_sent", "target_user_id": "987654321", "timestamp": "2026-05-21T00:15:15.000Z", "type": "user_contact", "user_id": "123456789", "client_info": { "ip": "203.0.113.7" }, "content_id": "message_abc123", "idempotency_key": "event_123_retry_key", "metadata": { "conversation_id": "conversation_789", "channel": "marketplace_dm" } }' ``` #### Response ```json { "status": "queued", "queued_events": 1 } ```