Automated campaigns

Send review requests automatically from a file your system produces, such as a daily export of completed jobs.

Send review requests automatically from a file your system produces, such as a daily export of completed jobs.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

MethodEndpointDescription
GETList automated campaignsPaginated list of the caller's automation campaigns (rs_campaigns.type = 'automation'), each including its file_header configuration (headers map, sample-file path, location identifier).
POSTDefine a file formatCreate the file-header (column-mapping) configuration for an automation campaign and uploads the sample file to S3.
GETGet a campaign's file formatGet the file-header configuration(s) for a given automation campaign.
PUTEdit a file formatUpdate an existing file-header configuration.
DELETEDelete a file formatDelete a file-header configuration and its associated sample file from S3.
GETDownload a sample fileGet the S3 URL and metadata (name, size, mime type) for the sample file attached to a file-header configuration.