Skip to main content

REST API

POST : sequence/rest/create_and_start

Create and start a sequence from an existing template:

InputMandatoryTypeObservation
template_idYString (uuid) or int (id)A valid sequence template uuid or id obtained from sequence_template/rest/list
titleYStringSequence title. If empty, template title will be used
deadlineYString (yyyy-mm-dd)Latest date by which sequence should be completed
input_contextInitial context affected to this new sequence.
user_messageStringInitial message showed to user(s) when entering into first pending form(s)
colorStringA color as string. Could be #html, named, or RGB color
priorityIntAn integer between 0 and 5
thumbnailStringA valid image url representing the new sequence
custom_css_idIntA valid css ID obtained from css list
allocation_dateString (yyyy-mm-dd)Default allocation date for all generated UI jobs
allocation_userIntA valid user ID obtained from User list



GET : sequence/rest/list

Return a list of paginated, filtered and ordered sequences:

InputMandatoryTypeObservation
seq_idIntExisting sequence ID obtained from sequence/rest/list or sequence/create_from_template
template_idStringExisting sequence template ID obtained from sequence_template/rest/list
created_byString or IntUsername or user id
state_filterStringValid state (see Sequence states)
sort_byStringValid column name used to sort result (see Sort by values)
deadlineString (yyyy-mm-dd)Latest date by which sequence should be completed
color_filterStringValid color code
startintFirst selection row index
lengthintNumber of retrieved rows
searchstringPerforms a 'contains' search on sequence name

Sequence states

StateObservation
IDLEFirst state occurring when sequence is created but not already started, or when start fails for any reason
IN_PROGRESSSequence is in progress, and no job is in error or lost.
DONESequence is done, ie complete jobs graph has been successfully executed
FAILEDOne or various jobs are in error
LOSTOne or various jobs are lost. Lost refers to workflow that does not respond within 1 minute
DELETINGSequence is being deleted
RESTARTINGSequence is being restarted (depending the sequence complexity, delete or restart a sequence could take some time)

Sort by values

To perform a descendant sort, just prefix sort key by a minus sign (ex: -seq_name):

Sort keyColumn
seq_nameSequence title specified in sequence/rest/create_and_start
idSequence ID returned by sequence/rest/create_and_start
seq_stateCurrent sequence progress (see: sequence_template/static_data)
seq_prioritySequence priority specified in sequence/rest/create_and_start
seq_created_by__usernameUsername who created the sequence
seq_count_execCounter incremented for each sequence restart
seq_deadlineDeadline date specified in sequence/rest/create_and_start
seq_start_dateDate on which the sequence starts
seq_end_dateDate on which the sequence terminates
seq_last_action_dateDate of the latest job action
seq_workflow_template__wft_nameSequence template name



GET : sequence/rest/static_data

Set of static data used by application:

KeyObservation
stateslist of all states used by Sequence manager
colorslist of all colors used by Sequence manager
job_categorieslist of job categories (ID, name)



GET : sequence_template/rest/list

Return a list of all sequence templates. Each entry will have the following data:

Ouput valueObservation
idSequence id
uuidUniversal sequence id
categorySequence category
nameTemplate name



GET : sequence/rest/data

Return a set of data for a specific sequence:

InputMandatoryTypeObservation
sequence_idYIntId of an existing sequence
Ouput valueObservation
sequence_template_nameTemplate name used to build the sequenbce
sequence_thumbnail
seq_workflow_template
seq_name
seq_state
seq_priority
seq_color
seq_count_execCounter incremented for each sequence restart
seq_deadlineDeadline date specified in sequence/rest/create_and_start
seq_start_dateDate on which the sequence starts
seq_end_dateDate on which the sequence terminates
created_byUsername who created sequence
created_by_idUser ID name who created sequence
last_activity
count_jobs_in_errorNumber of jobs in error
count_jobs_lostNumber of lost jobs
progress[current, max, key, count]



POST : sequence/rest/update_data

InputMandatoryTypeObservation
sequence_idYIntId of an existing sequence
titleStringNew title for this sequence
priorityIntAn integer between 0 and 5
deadlineString (yyyy-mm-dd)Latest date by which sequence should be completed
colorStringA color, preferably from sequence/rest/static_data
thumbnailStringValid image url
tagsStringTags list separated by comma



POST : sequence/rest/delete

Delete a selection of sequences:

InputMandatoryTypeObservation
idsY[]An array of existing sequence ids to delete



POST : sequence/rest/restart

Restart a selection of sequences:

InputMandatoryTypeObservation
idsY[]An array of existing sequence ids to delete