Sign in
latestOpenAPI 3.1.02026-08-218667571.2 MB

a8ca30023371

Admin APIs
block-data-approvals

Internal Approve Accounts

Approve at the Accounts internal step.

Body is optional — bare approval keeps the captured-at-creation trial duration and annual price. Pass trial_duration_months and/or annual_price with a custom_adjustment_rationale to apply a custom adjustment before the queue advances to Legal.

An annual_price above the catalog list price additionally requires above_list_acknowledged — 400 above_list_price otherwise, carrying both figures so the UI can render a confirmation.

s3_grant awards S3 tokens for the contract this request will become. The contract does not exist yet — the trial has not even started — so the award is held awaiting_contract and its vesting schedule is built when the subscription webhook lands, which is what lines each vest up with the invoice it funds. A Historic (one_time) request is refused with 400 s3_grant_rejected: its only invoice is raised before anything vests.

post/api/v1/admin/block/requests/{request_id}/internal-approve/accounts

Path parameters

request_idstring uuid required

Request body

trial_duration_monthsinteger nullable
custom_adjustment_rationalestring nullable
above_list_acknowledgedboolean nullable

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