COcontext
Utility

Prefetch brand data by email

Changed on

Signal that you may fetch brand data for a particular domain soon to improve latency. This endpoint accepts an email address, extracts the domain from it, validates that it's not a disposable or free email provider, and queues the domain for prefetching.

post/brand/prefetch-by-email

Request

  • Base URL
    https://api.context.dev/v1
  • URL
    https://api.context.dev/v1/brand/prefetch-by-email
  • Auth
    HTTP bearer

Request body

emailstring email required

Email address to prefetch brand data for. The domain will be extracted from the email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email addresses are not allowed.

timeoutMSinteger

Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).

tagsstring[]

Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

Example request

{
  "tags": [
    "production",
    "team-alpha"
  ]
}

Response

Successful response

statusstring

Status of the response, e.g., 'ok'

messagestring

Success message

domainstring

The domain that was queued for prefetching

Changes