protocols

Convert Protocol Endpoint

Convert a UCP to a vendor-native protocol file.

The primary artifact is returned as base64-encoded bytes alongside a suggested filename and media type. Some targets (currently Maccor with drive cycles) emit additional asset files in assets.

post/protocols/convert

Request body

target'maccor' | 'arbin' | 'arbin_sdx' | 'neware' | 'biologic_bttest' | 'novonix' required

Vendor target: 'maccor', 'arbin', 'neware', 'biologic_bttest', or 'novonix'.

drive_cyclesobject nullable

Optional mapping of drive cycle name → samples. Required when the protocol references DriveCycle steps.

filename_stemstring

Stem for the returned primary filename (no extension).

nominal_capacity_ahnumber nullable

Rated cell capacity in A.h, from the cell specification. Required for 'neware' when the protocol uses C-rate steps or cutoffs: Neware sets current in absolute mA and has no C-rate mode, so the rate cannot be resolved without it. Ignored by other targets, which express C-rate natively.

verifyboolean

Round-trip the emitted file back through its parser and refuse the conversion (400) if the protocol no longer means the same thing. A writer that drops a loop count, a goto, or a safety bound emits a valid file that simulates identically, so the loss would otherwise only show up on hardware. A re-encoding the target format forces — a C-rate resolved to absolute amps on a format with no C-rate type — is allowed. Off by default: the checker still reports two benign round-trip artifacts of Maccor/Arbin/Neware (explicit fall-through gotos and an appended terminal step) as differences, so enabling it by default would refuse most valid conversions to those targets.

Response

Successful Response

targetstring required
warningsstring[]

Changes