Agent tools

Subscribe a person to The Pulse by email with their explicit newsletter consent and chosen format, frequency and language. Validate with dryRun:true first. Live calls store a subscription, send a confirmation email and notify the team. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.

Compatibility alias for the v1 endpoint; no removal is scheduled.

post/api/agent/subscribe_pulse

Request

  • Base URL: https://www.reguscilabs.com
  • URL: https://www.reguscilabs.com/api/agent/subscribe_pulse
  • Auth: none required

Headers

Idempotency-Keystring

Reuse one key with identical input for retries for 7 days. The JSON idempotencyKey argument is equivalent (MCP/WebMCP). If both are provided they must match. Legacy calls without a key are accepted but are not safe to automatically retry. Cached outcomes replay; changed input or a pending outcome returns 409.

Request body

namestring required
emailstring email required
whatsappstring
deliveryFormat'audio' | 'text' | 'both' required
cadence'daily' | 'weekly' required
consenttrue required

The person explicitly opted into The Pulse. An inquiry does not imply newsletter consent.

idempotencyKeystring

Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.

locale'es' | 'en'
dryRunboolean

Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.

confirmedboolean

Set true only after the person explicitly approves sending these details to RegusciLabs.

Response

Typed result. Search, latest-news and curated-social-activity lists may return nextCursor (null at the end); reuse it with unchanged filters. Social activity is editorial, not live, with null dates when unverified. Validation always has submitted:false.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.