IOionworks
Pipeline

Get pipeline metadata

Changed on

Retrieves pipeline metadata only (no elements).

For elements, use GET /pipelines/{pipeline_id}/elements.

get/pipelines/{pipeline_id}

Request

  • Base URL
    https://api.ionworks.com
  • URL
    https://api.ionworks.com/pipelines/{pipeline_id}
  • Auth
    none declared

Path parameters

pipeline_idstring uuid required

Response

Successful Response

urlstring nullable
api_urlstring nullable
status'pending' | 'running' | 'completed' | 'failed' | 'canceled' required
idstring required
project_idstring required
user_idstring nullable
namestring required
descriptionstring nullable
created_atstring date-time required
updated_atstring date-time required
errorstring nullable
error_code'CONFIGURATION_ERROR' | 'MODEL_ERROR' | 'SOLVER_ERROR' | 'MAX_BACKWARD_JUMPS_EXCEEDED' | 'EXECUTION_TIMEOUT' | 'SUBMISSION_FAILED' | 'INTERNAL_ERROR'

Machine-readable error codes for jobs.

created_by_emailstring nullable
organization_idstring required

Organization this pipeline belongs to.

is_terminalboolean required

Whether the pipeline has settled and will not transition again.

is_failedboolean required

Whether the pipeline settled on anything other than success.

Derived as terminal-minus-success, so a new non-success terminal status is classified without editing this method.

Changes

  • 3abf50e2d741Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • ea3d377fec1aRevision changes
    • breaking

      for the path request parameter pipeline_id, the format changed from no format to uuid

    • warning

      added the new MAX_BACKWARD_JUMPS_EXCEEDED enum value to the / response property for the response status