IOionworks
Cyclers
Channels

Create a new channel for a cycler

Changed on

Create a new channel under the specified cycler (by ID).

Returns the created channel and sets the Location header.

post/cyclers/{cycler_id}/channels

Request

  • Base URL
    https://api.ionworks.com
  • URL
    https://api.ionworks.com/cyclers/{cycler_id}/channels
  • Auth
    none declared

Path parameters

cycler_idstring uuid required

Request body

object required

Response

Successful Response

namestring required

Name of the channel

notesstring nullable

Free-text notes about the channel

cycler_idstring required

Foreign key to the parent cycler

max_ampsnumber nullable

Maximum rated current for the channel, in amps (A).

min_voltsnumber nullable

Minimum rated voltage for the channel, in volts (V).

max_voltsnumber nullable

Maximum rated voltage for the channel, in volts (V).

idstring required

Unique identifier for the channel

out_of_commissionboolean

Whether the channel is deliberately out of service (broken or under maintenance). An out-of-commission channel is shown as such in the Lab view and is not counted as available.

organization_idstring required

Organization this channel belongs to.

project_idstring required

Project that owns this channel (inherited from its cycler)

created_bystring nullable

User ID of the user who created this channel

created_by_emailstring nullable

Email of the user who created this channel

created_atstring date-time required

Timestamp when the channel was created

updated_atstring date-time required

Timestamp when the channel was last updated

Changes