latestOpenAPI 3.1.02026-08-218667571.2 MB

a8ca30023371

Admin APIs
block-data-approvals

Shift Trial Window

QA lever: time-warp a request's trial window so it ends N seconds from now, with trial_start_date derived from trial_duration_months so the row stays internally consistent. Disabled in production.

Seconds is the wire unit so callers can pick any granularity (days, hours, minutes, seconds). Useful for two test cases without waiting real time:

  • "Trial has X left" — pass a small positive seconds_until_end.
  • "Trial starts in X" (cancellation-cutoff UI) — pass trial_duration_months * 30 * 86400 + X.
put/api/v1/admin/block/requests/{request_id}/trial-window

Path parameters

request_idstring uuid required

Request body

seconds_until_endinteger required

Response

Successful Response

idstring uuid required
dataset_idstring required
lagstring nullable
cutstring nullable
labelstring nullable
internal_namestring nullable
core_sourcestring nullable
client_idstring uuid required
client_polaris_principal_missingboolean
client_namestring nullable
requestor_emailstring required
status'pending_block_admin' | 'pending_compliance' | 'pending_internal' | 'approved' | 'intake_pending' | 'provisioning' | 'provisioning_failed' | 'trial_pending' | 'trial_active' | 'contracted' | 'contract_expired' | 'request_cancelled' | 'trial_cancelled' | 'contract_cancelled' | 'block_cancelled' | 'rejected' required
internal_queue_step'accounts' | 'legal' | 'engineering' | 'complete'
rejection_source'client_block_admin' | 'client_compliance' | 'carbonarc_accounts' | 'carbonarc_legal' | 'carbonarc_engineering'
rejection_messagestring nullable
rejected_bystring nullable
fee_type'one_time' | 'annual' required
trial_duration_monthsinteger required
annual_pricestring nullable
original_trial_duration_monthsinteger nullable
original_annual_pricestring nullable
custom_adjustment_rationalestring nullable
additional_email_recipientsstring[]
use_casestring nullable
trial_start_datestring date-time nullable
trial_end_datestring date-time nullable
original_trial_start_datestring date-time nullable
original_trial_end_datestring date-time nullable
first_ingestion_atstring date-time nullable
trial_start_trigger'first_ingestion' | 'auto_start'
approved_by_block_adminstring nullable
approved_by_compliancestring nullable
approved_atstring date-time nullable
cancellation_requested_atstring date-time nullable
cancellation_requested_bystring nullable
cancellation_request_reasonstring nullable
created_atstring date-time required
updated_atstring date-time required