Qorus Integration Engine® Enterprise Edition 6.0.25_prod
|
This REST URI path provides qorus metrics
TODO:
the todo partThis REST URI path provides actions and information about queues for asynchronous workflow steps
queueid:
the queue IDname:
the queue nameThis REST API path provides actions and information about Qorus class objects
list:
optional; parsed with Qore::parse_boolean(); if True then a list of class names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with class names, versions, and IDs is returnedlist
nor short
options are passed as above):classid:
the class IDname:
the name of the classversion:
the version of the classdescription:
the description of the class objectauthor:
the author of the class objectcreated:
the date/time the class object was createdmodified:
the date/time the class object was modifiedsource:
the source file that the class object was created fromline:
the offset in the source file for the source of the class objectThis REST API path provides actions and information about specific class objects
name:
the name of the class objectversion:
the version of the class objectclassid:
the class object IDdescription:
the description of the classauthor:
the author of the classbody:
the source code for the class objectcreated:
the date/time the class was createdmodified:
the date/time the class was modifiedcreatedby:
(deprecated) always "omq"
modifiedby:
(deprecated) always "omq"
tags:
any user-defined tags on the class objectsource:
the source file that the class object was created fromoffset:
the offset in the source file for the source of the class objecthost:
the hostname of the machine where the class object was loaded fromuser:
the OS user who loaded the class objectThis REST API path provides actions and information about Qorus constant objects
list:
optional; parsed with Qore::parse_boolean(); if True then a list of constant names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with constant names, versions, and IDs is returnedlist
nor short
options are passed as above):constantid:
the constant IDname:
the name of the constantversion:
the version of the constantdescription:
the description of the constant objectauthor:
the author of the constant objectcreated:
the date/time the constant object was createdmodified:
the date/time the constant object was modifiedsource:
the source file that the constant object was created fromline:
the offset in the source file for source of the constant objectThis REST API path provides actions and information about specific constant objects
name:
the name of the constant objectversion:
the version of the constant objectconstantid:
the constant object IDdescription:
the description of the constant objectauthor:
the author of the constant objectbody:
the source code for the class objectcreated:
the date/time the constant object was createdmodified:
the date/time the constant object was modifiedcreatedby:
(deprecated) always "omq"
modifiedby:
(deprecated) always "omq"
tags:
any user-defined tags on the constant objectsource:
the source file that the constant object was created fromoffset:
the offset in the source file for the source of constant objecthost:
the hostname of the machine where the constant object was loaded fromuser:
the OS user who loaded the constant objectThis REST URI path provides actions and information related to Qorus system debugging
This REST URI path provides information related to Qorus remote development data
This REST URI path provides information related to Qorus internal interface action serialization data
This REST URI path provides information related to the internal Qorus service cache
This REST URI path provides summary information related to internal Qorus order statistics processing data
This REST URI path provides information related to internal Qorus synchronization event cache data
This REST URI path provides information related to internal Qorus synchronization event cache summary info
This REST URI path provides information related to Qorus threads
This REST URI path provides actions and information related to a single Qorus thread
This REST URI path provides information related to Qorus internal workflow control data
This URI path provides actions and information related to workflow errors
errors:
optional; a comma-separated string will be split into a list; the workflow errorsfilter:
optional; if "global"
then only global errors will be listed; other values for this argument key are ignored; takes precendence over wf
list:
optional; parsed with Qore::parse_boolean(); if True then a list of error names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with error names and brief info is returnedwf:
optional; a workflow ID or name to use to filter the results with; ignored if filter
= "global"
business_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)forceworkflow:
(optional) parsed with Qore::parse_boolean(); if True then the workflow error will be created as a workflow-specific error even if no global error exists; default if not present False; only used if workflowid
also presentretry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesworkflowid:
(optional string) an optional workflow ID for potentially creating a workflow-specific workflow error definition"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False) est)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)409 Conflict
: ERROR-EXISTS
: this exception is thrown if the workflow-specific error definition already existsworkflowid
and forceworkflow
options as described abovebusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)forceworkflow:
(optional) parsed with Qore::parse_boolean(); if True then the workflow error will be created as a workflow-specific error even if no global error exists; default if not present False; only used if workflowid
also presentretry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesworkflowid:
(optional string) an optional workflow ID for potentially creating a workflow-specific workflow error definition"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False)"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)workflowid
and forceworkflow
options as described aboveglobal:
gives the number of global error definitions loadedworkflow:
gives the number of all workflow-specific error definitions loaded403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationerrors:
a comma-separated string will be split into a list; the workflow errors to search forThis REST URI path provides actions and information related to global workflow errors
errors:
optional; a comma-separated string will be split into a list; the global workflow errors to returnlist:
optional; parsed with Qore::parse_boolean(); if True then a list of error names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with error names and brief info is returnedbusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"CREATED-GLOBAL"
indicating that a new global workflow error was created403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: ERROR-EXISTS
: this exception is thrown if the global workflow error already existsbusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"UPDATED-GLOBAL"
: the existing global error was updated"CREATED-GLOBAL"
: a new global error was created"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis URI path provides actions and information related to a specific global workflow error
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdescription:
(string) the new description of the errorseverity:
(string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesretry_flag:
(bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)business_flag:
(bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)"UPDATED-GLOBAL"
: the existing global error was updated"CREATED-GLOBAL"
: a new global error was created (only possible in case of a race condition where the current error was deleted during this request)"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis URI path provides actions and information related to workflow-specific workflow-specific workflow errors across all workflows
errors:
optional; a comma-separated string will be split into a list; the workflow-specific workflow errors for all accessible workflows to returnlist:
optional; parsed with Qore::parse_boolean(); if True then a list of error names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with error names and brief info is returnedThis URI path provides actions and information related to workflow-specific workflow errors for a particular workflow
errors:
optional; a comma-separated string will be split into a list; the workflow-specific workflow errors for the current workflow to returnlist:
optional; parsed with Qore::parse_boolean(); if True then a list of error names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with error names and brief info is returnedbusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)forceworkflow:
(optional) parsed with Qore::parse_boolean(); if True then the workflow error will be created as a workflow-specific error even if no global error exists; default if not present Falseretry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)409 Conflict
: ERROR-EXISTS
: this exception is thrown if the workflow-specific error definition already existsforceworkflow
option as described abovebusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False)"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition (only possible if forceworkflow
is omitted or False)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)forceworkflow
option as described aboveThis URI path provides actions and information related to a workflow-specific workflow error
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdescription:
(string) the new description of the errorseverity:
(string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesretry_flag:
(bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)business_flag:
(bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created (only possible in case of a race condition where the current error was deleted during this request)"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)This URI path provides actions and information related to a specific workflow error
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdescription:
(string) the new description of the errorseverity:
(string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesretry_flag:
(bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)business_flag:
(bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)retry_delay_secs:
(optional int) an optional retry value in seconds (only accepted if retry_flag
is also True)"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created (only possible in case of a race condition where the current error was deleted during this request)"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition"UPDATED-GLOBAL"
: the existing global error was updated"CREATED-GLOBAL"
: a new global error was created (only possible in case of a race condition where the current error was deleted during this request)"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: ERROR-UPDATE-ERROR
: invalid keys or key values provided in the error description hashThis URI path provides actions and information regarding workflow execution instances.
groups:
list of interface groups that the workflow belongs to; each list element is a REST Interface Group Hash (may be empty)alerts:
a list of alerts raised against the workflow; each list element is a REST Alert Hash (may be empty)log_url:
a complete URL to the websocket source for the workflow logcount:
number of workflow execution instances stoppedworkflows:
a hash keyed by workflow description where the values are the lists of all execution instance IDs stopped for that workflowmsg:
a descriptive message about the workflows stoppedargs:
(required) one or more workflow names or IDs to stopcount:
number of workflow execution instances stoppedworkflows:
a hash keyed by workflow description where the values are the lists of all execution instance IDs stopped for that workflowmsg:
a descriptive message describing the workflow execution instances that were stoppedThis URI path provides actions and information regarding a particular workflow execution instance.
groups:
list of interface groups that the workflow belongs to; each list element is a REST Interface Group Hash (may be empty)alerts:
a list of alerts raised against the workflow; each list element is a REST Alert Hash (may be empty)log_url:
a complete URL to the websocket source for the workflow logoptions:
a hash of options to set against the workflow; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())409 Conflict
: WORKFLOW-OPTION-ERROR
: invalid option for workflow or option cannot be overridden at the workflow level403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)"OK"
if successful.This URI path provides actions and information about workflow execution instances for a particular workflow.
groups:
list of interface groups that the workflow belongs to; each list element is a REST Interface Group Hash (may be empty)alerts:
a list of alerts raised against the workflow; each list element is a REST Alert Hash (may be empty)log_url:
a complete URL to the websocket source for the workflow logoptions:
a hash of options to set against the workflow; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())409 Conflict
: WORKFLOW-OPTION-ERROR
: invalid option for workflow or option cannot be overridden at the workflow level403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)stopped:
the value is a descriptive string for the workflow"no instances to stop"
.403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)This REST API path provides actions and information about Qorus functions
list:
optional; parsed with Qore::parse_boolean(); if True then a list of function names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with function names, versions, and IDs is returnedlist
nor short
options are passed as above):name:
the name of the functionversion:
the version of the functionfunction_instanceid:
the function IDfunction_type:
the type of function object; see Step Function Types for possible valuesdescription:
the description of the functionauthor:
the author of the functioncreated:
the date/time the function was createdmodified:
the date/time the function was modifiedsource:
the source file that the function object was created fromline:
the offset in the source file for the source of the function objectThis REST API path provides actions and information about specific functions
This URI path provides actions and information related to interface groups
groups:
(required) list of strings or a single string; a comma-separated string will be split into a list; the names of the groups to delete403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: GROUPS-DELETE-ERROR
: missing groups
argumentlist:
optional; parsed with Qore::parse_boolean(); if True then a list of group names is returnedno_synthetic:
optional; parsed with Qore::parse_boolean(); if True then synthetic groups will not be included in the return valueshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings of group names and descriptions is returnedlist
or short
are present, this API returns a list of REST Interface Group Detail Hash elements according to the arguments.group:
(string) required; the name of the groupdesc:
(string) required; the description of the groupworkflows:
(list of strings or a single string) optional; a comma-separated string will be split into a list; the list of workflow names or IDs to include in the groupservices:
(list of strings or a single string) optional; a comma-separated string will be split into a list; the list of user service names or IDs to include in the groupjobs:
(list of strings or a single string) optional; a comma-separated string will be split into a list; the list of job names or IDs to include in the groupmappers:
(list of strings or a single string) optional; a comma-separated string will be split into a list; the list of mapper names or IDs to include in the groupvmaps:
(list of strings or a single string) optional; a comma-separated string will be split into a list the list of value map names or IDs to include in the groupenabled:
(string) this value will be processed by parse_boolean(); the initial enabled flag for the group; if not present defaults to True403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: WORKFLOW-ERROR
: invalid or unknown workflow409 Conflict
: SERVICE-ERROR
: invalid or unknown service409 Conflict
: JOB-ERROR
: invalid or unknown job409 Conflict
: MAPPER-ERROR
: invalid or unknown mapper409 Conflict
: VALUE-MAP-ERROR
: invalid or unknown value map409 Conflict
: GROUP-ERROR
: missing group
or desc
argumentsgroups:
(required) one or more group names to modify; a comma-separated string will be split into a listenabled:
(required) parsed with Qore::parse_boolean(); the new enabled status for the group(s)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: GROUPS-SETSTATUS-ERROR
: missing groups
or enabled
argumentsThis URI path provides actions and information related to a specific interface group
info:
a string describing the group deletion action403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: cannot update group "DEFAULT"
desc:
(string) the new description of the groupworkflows:
(list of strings or a single string) the list of workflow names to include in the group; the new list will replace the current list unless the workflow names are preceded by "+"
or "-"
, meaning add or remove a workflow, respectively (in which case all workflow names must be preceded by a "+"
or "-"
)services:
(list of strings or a single string) the list of user service names to include in the group; the new list will replace the current list unless the user service names are preceded by "+"
or "-"
, meaning add or remove a service, respectively (in which case all service names must be preceded by a "+"
or "-"
)jobs:
(list of strings or a single string) the list of job names to include in the group; the new list will replace the current list unless the job names are preceded by "+"
or "-"
, meaning add or remove a job, respectively (in which case all job names must be preceded by a "+"
or "-"
)mappers:
(list of strings or a single string) the list of mapper names to include in the group; the new list will replace the current list unless the mapper names are preceded by "+"
or "-"
, meaning add or remove a mapper, respectively (in which case all mapper names must be preceded by a "+"
or "-"
)vmaps:
(list of strings or a single string) the list of value map names to include in the group; the new list will replace the current list unless the value map names are preceded by "+"
or "-"
, meaning add or remove a value map, respectively (in which case all value map names must be preceded by a "+"
or "-"
)enabled:
(string) this value will be processed by parse_boolean(); enables or disables the group"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Conflict
: RBAC-UPDATE-GROUP-ERROR
: at least one of desc
, services
, workflows
, jobs
, mappers
, vmaps
, or enabled
keys must be passed in the second argument hash to update the group403 Forbidden
: cannot update group "DEFAULT"
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: cannot update group "DEFAULT"
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: cannot update group "DEFAULT"
enabled:
(required) parsed with Qore::parse_boolean(); the new enabled status for the groupinfo:
a string describing the group enabled status change403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: GROUP-SETSTATUS-ERROR
: missing enabled
argumentThis REST API path provides actions and information about job results (job instances).
date:
optional (parsed as a date); the past cutoff date for the search; only orders with a modified
date equal or after this date will be considered; if not present, then defaults to the last 24 hoursdesc:
optional (parsed with Qore::parse_boolean(); determines the sort order; if False then results are sorted in ascending order, if True (the default), results are sorted in descending order (newest first)full:
optional (parsed with Qore::parse_boolean(); if True then additional keys are included in each result record; see below for detailsids:
optional; one or more job IDs to filter the result list; a comma-separated string will be split into a listlimit:
optional; limits the number of results returnedoffset:
optional; the starting result to return (use when paging for example)sort:
optional; a list of columns to sort the output bystatuses:
optional; job result (job instance) status value(s); a comma-separated string will be split into a list (see Job Data Status Descriptions for possible values)full
option is set, then the following additional keys are included in each hash:errors:
a list of hashes of errors and warnings raised by the job; each list element has the following keys:job_errorid:
the unique ID for the error instanceseverity:
an error severity code (see Error Severity Codes for possible values)error:
the error code stringdescription:
description for the error (if any)info:
additional information about the error (if any)business_error:
a boolean flag indicating of the error is a business errorcreated:
the date and time the error was raisedaudit:
a list of one or more REST Audit Info Hash elements (can be empty)date:
optional (parsed as a date); the past cutoff date for the search; only orders with a modified
date equal or after this date will be considered; if not present, then defaults to the last 24 hourssqlcache:
optional (parsed with Qore::parse_boolean()); if False then no SQL cache will be used for historical info; default Truecombined:
if True then all results are combined into one global hash for all queried jobsjobs:
one or more job names or IDs to filter the result list; a comma-separated string will be split into a listcombined
is set, described above)myjob_1 : hash: (2 members) ERROR : 1 COMPLETE : 3 myjob_2 : hash: (2 members) IN-PROGRESS : 1 COMPLETE : 8
This REST API path provides actions and information about specific job results (job instances).
errors:
a list of hashes of errors and warnings raised by the job; each list element has the following keys:job_errorid:
the unique ID for the error instanceseverity:
an error severity code (see Error Severity Codes for possible values)error:
the error code stringdescription:
description for the error (if any)info:
additional information about the error (if any)business_error:
a boolean flag indicating of the error is a business errorcreated:
the date and time the error was raisedaudit:
a list of one or more REST Audit Info Hash elements (can be empty)This REST API path provides actions and information related to Qorus jobs.
defonly:
optional (parsed with Qore::parse_boolean()); if True then no job result information will be included in the return value; default Falsedate:
optional (parsed as a date); the past cutoff date for job result (job instances) for the return value; if not present, then defaults to the last 24 hoursjobs:
one or more job names or IDs to filter the result list; a comma-separated string will be split into a listlib_source:
optional; parsed with Qore::parse_boolean(); if True then the source code for each library object is returned in the REST Job Description Hashlist:
optional; parsed with Qore::parse_boolean(); if True then a list of job names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings of job names and descriptions is returnedsqlcache:
optional (parsed with Qore::parse_boolean()); if False then no SQL cache will be used for historical info; default True (only used if defonly
is omitted or False)status:
options; either "active"
or "inactive"
to filter jobs based on their active statuslist
nor short
are used, then this API returns a list of REST Job Description Hash elements; if defonly
is not True, then any jobs with job result data within the given time period (as defined by the date
option) will be reflected in the following extra keys:IN-PROGRESS
: the number of job instances currently in progressCOMPLETE:
the number of job instances with a OMQ::StatComplete status during the given time periodERROR:
the number of job instances with a OMQ::StatError status during the given time periodids:
(required) one or more job names or IDs to disable; a comma-separated string will be split into a list409 Conflict
: JOB-DISABLE-ERROR
: missing ids
argumentids:
(required) one or more job names or IDs to enable; a comma-separated string will be split into a list409 Conflict
: JOB-ENABLE-ERROR
: missing ids
argumentids:
(required) one or more job names or IDs to reset; a comma-separated string will be split into a list403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationids:
(required) one or more job names or IDs to run; a comma-separated string will be split into a listarg:
the job ID or name (the argument passed as input)run:
True means the job was run, False means it was notinfo:
an informative string giving a description of the result or an error messagejobid
]: the job IDname
]: the name of the jobversion
]: the version of the jobjob_instanceid
]: the job_instanceid of the job executedstatus
]: the status of the execution of the job; see Job Data Status Descriptions for possible values403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST API path provides actions and information related to specific jobs; the name can also be provided in the format name:version
.
state:
a hash of job state data (if any)403 Forbidden
: JOB-ACCESS-ERROR
: the user does not have the right to access the given job (for more information, see Interface Groups)jobid
(int): the workflow IDname
(string): the wojobrkflow nameversion
(string): the job versioninfo
(string): a string providing information about the job update action403 Forbidden
: access or authorization error409 Conflict
: exception processing the requestjobid
(int): the workflow IDname
(string): the wojobrkflow nameversion
(string): the job versioninfo
(string): a string providing information about the job update action403 Forbidden
: access or authorization error409 Conflict
: exception processing the request403 Forbidden
: access or authorization error409 Conflict
: API-CALL-ERROR
: cannot reset a disabled jobjob_instanceid
(int): the job_instanceidstatus
(string): the status of the execution of the job; see Job Data Status Descriptions for possible values403 Forbidden
: access or authorization errorschedule
(*string): a cron-like string giving the job schedule, see job schedule for information about the format; either this parameter or duration
must be present, but not bothduration
(*int): a duration in seconds for triggering the job; either this parameter or schedule
must be present, but not both; the duration must be less than 10^7.jobid
(int): the job IDname
(string): the job nameschedule
(*string): the new schedule for the jobduration
(*int): the new dduration for the jobinfo
(string): a descriptive string403 Forbidden
: access or authorization erroractive:
(required) parsed with Qore::parse_boolean(); the active state of the jobjobid:
the job IDname:
the job nameactive:
the new active state of the jobinfo:
a descriptive string; ex: jobid 7 "myjob1" is already active and running
403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: JOB-ACCESS-ERROR
: the user does not have the right to access the given job (for more information, see Interface Groups)409 Conflict
: JOB-ERROR
: cannot set expired jobs to activedate
(*date): the new expiry date of the job; if not present any expiry date will be removedjobid
(int): the job IDname
(string): the job nameexpiry_date
(*date): the new expiry date of the jobinfo
(string): a descriptive string403 Forbidden
: access or authorization erroroptions:
a hash of options to set against the job; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash"OK"
upon successful execution400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())403 Forbidden
: JOB-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given job (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: JOB-OPTION-ERROR
: invalid option for job or option cannot be overridden at the job leveldata:
a hash of new job state data or NOTHING which will clear any data403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: JOB-ACCESS-ERROR
: the user does not have the right to access the given job (for more information, see Interface Groups)This REST API path provides actions and information related to the results of specific jobs.
date:
optional (parsed as a date); the past cutoff date for the search; only orders with a modified
date equal or after this date will be considered; if not present, then defaults to the last 24 hoursdesc:
optional (parsed with Qore::parse_boolean(); determines the sort order; if False then results are sorted in ascending order, if True (the default), results are sorted in descending order (newest first)full:
optional (parsed with Qore::parse_boolean(); if True then additional keys are included in each result record; see below for detailsids:
optional; one or more job instance IDs to filter the result list; a comma-separated string will be split into a listlimit:
optional; limits the number of results returnedoffset:
optional; the starting result to return (use when paging for example)sort:
optional; a list of columns to sort the output bystatuses:
optional; job result (job instance) status value(s); a comma-separated string will be split into a list (see Job Data Status Descriptions for possible values)full
option is set, then the following additional keys are included in each hash:errors:
a list of hashes of errors and warnings raised by the job; each list element has the following keys:job_errorid:
the unique ID for the error instanceseverity:
an error severity code (see Error Severity Codes for possible values)error:
the error code stringdescription:
description for the error (if any)info:
additional information about the error (if any)business_error:
a boolean flag indicating of the error is a business errorcreated:
the date and time the error was raisedaudit:
a list of one or more REST Audit Info Hash elements (can be empty)date:
optional (parsed as a date); the past cutoff date for the search; only orders with a modified
date equal or after this date will be considered; if not present, then defaults to the last 24 hourssqlcache:
optional (parsed with Qore::parse_boolean()); if False then no SQL cache will be used for historical info; default Truecombined:
if True then all results are combined into one global hash for all queried jobscombined
is set, described above)myjob_1 : hash: (2 members) ERROR : 1 COMPLETE : 3 myjob_2 : hash: (2 members) IN-PROGRESS : 1 COMPLETE : 8
This REST API path provides the logout action
This REST URI path provides actions and information related to Qorus system logs and websocket log sources
type:
one of the following values:"qorus-core"
: the main system log file"audit"
: the system audit log file"http"
: the HTTP log file"mon"
: the system monitoring log file"alert"
: the system alert log file"workflow"
: a workflow log file"service"
: a service log file"job"
: a job log file"qdsp"
: a qdsp process log filelog:
the log file path on the host filesystemlog_url:
the websocket log URL for the log filename
]: (for workflows, services, and jobs) the name of the interfaceversion
]: (for workflows, services, and jobs) the version of the interfaceworkflowid
]: (for workflows) the ID of the workflowserviceid
]: (for services) the ID of the servicejobid
]: (for jobs) the ID of the jobservicetype
]: (for services) the type of the service ("system"
or "user"
)This URI path provides actions and information related to system mappers
full:
optional; parsed with Qore::parse_boolean(); if True then the output hashes will include mapper source informationlist:
optional; parsed with Qore::parse_boolean(); if True then a list of mapper names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with mapper names and brief info is returnedfull
option is used, then each hash has the following additional keys:option_source:
a hash of the source for the "options"
keyfield_source:
a hash of the source for the actual mapper logic itself; keys are output field namesids
argument from the DBids:
(required) a comma-separated string will be split into a list; the mapper names or IDs to reset403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: MAPPER-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given mapper (for more information, see Interface Groups)409 Conflict
: MAPPER-ERROR
: invalid or unknown mapper"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: MAPPER-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given mapper (for more information, see Interface Groups)This URI path provides actions and information related to a specific system mapper
option_source:
a hash of the source for the "options"
keyfield_source:
a hash of the source for the actual mapper logic itself; keys are output field names409 Conflict
: MAPPER-ERROR
: invalid or unknown mapper403 Forbidden
: MAPPER-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given mapper (for more information, see Interface Groups)"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: MAPPER-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given mapper (for more information, see Interface Groups)This REST URI path provides actions and information related to all mapper types
This REST URI path provides actions and information related to a specific mapper type
This URI path provides information and actions related to workflow order data.
date:
an alternate key for modified
desc:
return in descending orderids:
an alternate key for workflow_instanceid
key:
an alternate key for keyname
keyname:
the name of a search key to be used with the keyvalue value(s)keyvalue:
the value(s) of workflow order search key(s) to use (optionally used in conjunction with keyname)limit:
max number of rows to return, if not given, then the value of the "row-limit" option is used (default: 100)maxmodified:
maximum modified datemaxstarted:
maximum start dateminstarted:
minimum start datemodified:
minimum modified date; if this key is not sent with the request, and no keyvaue
, keyname
or workflow_instanceid
keys are sent, then a value one week before the time of the request is assumedoffset:
row offsetsort:
columns for sorting the resultsstatus:
status value(s) (see Workflow, Segment, and Step Status Descriptions for possible values)statuses:
an alternate key for status
wfid:
an alternate key for workflowid
workflowid:
one or more workflow IDsworkflow_instanceid:
workflow_instanceid values(s)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow order instance IDworkflowid:
the workflow IDworkflowstatus:
the status of the workflow order instance (see Workflow, Segment, and Step Status Descriptions for possible values)status_sessionid:
the application session ID that owns the workflow order instance data or 0 if the data is now owned by any application sessionstarted:
the start date/time of the workflow order instancecompleted:
the completed date/time for the workflow order instancemodified:
the last modified date/time of the workflow order instanceparent_workflow_instanceid:
the parent workflow order ID if presentsynchronous:
if 1, indicates that the order is being executed synchronouslybusiness_error:
a boolean flag indicating if the workflow order has an error status due to a business erroroperator_lock:
a string giving the username of the user with an operator lock on the ordernote_count:
the number of notes stored against the orderwarning_count:
the number of warnings raised against the ordererror_count:
the number of errors raised against the ordercustom_status:
a custom status for the orderpriority:
the priority of the workflow orderscheduled:
the future scheduled date for the workflow order (if any)custom_status_desc:
a description for the custom status (if any)actions:
a list of possible actions on the workflowids:
(required) one or more workflow instance IDs to block; a comma-separated string will be split into a listworkflow_status:
the status of the workflow order"BLOCK-WORKFLOW-ERROR"
: invalid status, foreign session id, missing original status, unblock operation already in progress"WORKFLOW-ACCESS-ERROR"
: the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationworkflow_status:
the status of the workflow order409 Conflict
: CANCEL-WORKFLOW-ERROR
: invalid status, foreign session id, missing original status, uncancel operation already in progress403 Forbidden
: WORKFLOW-ACCESS-ERROR
: Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationorderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagworkflow_instanceid:
limit the search to one or more workflow_instanceidserror_instanceid:
limit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchworkflowid:
limit the search to one or more workflowidsworkflowstatus:
limit the search to workflow instances with the given status value(s)limit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)mindate:
(required) minimum datemaxdate:
maximum datewfids:
optional workflow IDsseconds:
if True then the performance values will be returned as arbitrary-precision numeric values representing seconds, otherwise they will be returned as relative date/time valuesglobal:
if True then all workflows will be combined into an overall processing report, if False then each workflow gets a separate line in the output"hourly"
: hourly grouping"daily"
: daily grouping"monthly"
: monthly grouping"yearly"
: yearly groupingworkflowid:
the workflow IDname:
the workflow nameversion:
the workflow versioncount:
the number of workflow orders in the periodminstarted:
the minimum workflow order start datemaxcompleted:
the maximum workflow order completion date (if any)minduration:
the minimum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)avgduration:
the average total elapsed order processing time for workflow orders in the period (starting from workflow order creation)maxduration:
the maximum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)minprocessing:
the minimum order processing time for workflow orders in the period (starting from when then order was first processed)avgprocessing:
the average order processing time for workflow orders in the period (starting from when then order was first processed)maxprocessing:
the maximum order processing time for workflow orders in the period (starting from when then order was first processed)409 Conflict
: ARGUMENT-ERROR
: missing mindate
ids:
(required) one or more workflow instance IDs to retry; a comma-separated string will be split into a liststeps_updated:
(deprecated) always 0 in this version of Qorussegments_updated:
the number of segments updatedworkflow_updated:
always True in this version of Qorusworkflow_status:
always OMQ::StatRetry in this version of Qoruscached:
True if the workflow data is currently cached"STATUS-ERROR"
: workflow data does not have OMQ::StatError, OMQ::StatAsyncWaiting, or OMQ::StatRetry status"SESSION-ERROR"
: cannot change status for workflow data managed by another Qorus instance (foreign session ID)"RETRY-ERROR"
: invalid workflow instance ID"WORKFLOW-ACCESS-ERROR"
: the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationworkflow_status:
the status of the workflow order"BLOCK-WORKFLOW-ERROR"
: invalid status, foreign session id, missing original status, block operation already in progress"WORKFLOW-ACCESS-ERROR"
: Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationworkflow_status:
the status of the workflow order"CANCEL-WORKFLOW-ERROR"
: invalid status, foreign session id, missing original status, cancel operation already in progress"WORKFLOW-ACCESS-ERROR"
: Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)400 Bad Request
: all uncancel operations failed403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation200 OK
response is returnedThis REST URI path provides actions and information about specific workflow orders.
name:
the name of the workflowversion:
the version of the workflowauthor:
the author of the workflowworkflow_instanceid:
the workflow order instance IDworkflowid:
the ID of the workflowworkflowstatus:
the status of the workflow order (see Workflow, Segment, and Step Status Descriptions for possible values)status_sessionid:
the ID of the Qorus application session managing the workflow order data or 0 if noneparent_workflow_instanceid:
the workflow order instance ID of the parent order for this workflow or NULL if nonesubworkflow:
if 1, indicates that the parent_workflow_instanceid
is the parent workflow order in a subworkflow relationshipsynchronous:
if 1, indicates that the order is being executed synchronouslyerrors:
the number of errors raised against the orderbusiness_error:
a boolean flag indicating if the workflow order has an error status due to a business errorworkflowstatus_orig:
if the order status is OMQ::StatBlocked or OMQ::StatCanceled, this value will reflect the original status of the workflow order (see Workflow, Segment, and Step Status Descriptions for possible values)custom_status:
a custom status for the orderscheduled:
the scheduled datepriority:
the priority of the workflow orderstarted:
the date/time the order was createdcompleted:
the date/time order processing completedmodified:
the last modified date/time for the orderoperator_lock:
a string giving the username of the user with an operator lock on the ordernote_count:
the number of notes stored against the orderdeprecated:
a boolean value indicating if the workflow is deprecated or not; deprecated workflows are by default not displayed in the UIautostart:
the integer autostart value for the workflowmanual_autostart:
a boolean flag set if the autostart
value has been changed manually, in which case the manual setting takes precendence over any new definitions loaded with oloadmax_instances:
a value limiting the maximum number of execution instances that can run at onceexternal_order_instanceid:
a unique external key for the orderstaticdata:
a hash of workflow order static datadynamicdata:
a hash of workflow order dynamic data (if any)keys:
a hash of workflow order keys and valueswarning_count:
the number of warnings raised against the ordererror_count:
the number of errors raised against the orderStepInstances:
a list of step hashes giving information about the execution status of workflow steps; each element is a hash with the following keys:workflow_instanceid:
stepid:
the ID of the stepind:
the step array index starting with 0stepname:
the name of the stepstepversion:
the version of the stepsteptype:
type of the stepstepstatus:
the current execution status of the step (see Workflow, Segment, and Step Status Descriptions for possible values)retries:
the number of retries executed on the stepskip:
a boolean value indicating if the step logic was skippedcustom_status:
a custom status for the stepstarted:
the date/time the step was first executedcompleted:
the date/time step processing completedfunction_instanceid:
the function ID of the primary step functionsubworkflow_instanceid:
the workflow order ID of any subworkflow order instance (for bound subworkflow steps only)business_error:
a boolean flag indicating if the step has an error status due to a business errorErrorInstances:
a list of hashes giving information about errors and warnings raised against the order; each element is a hash with the following keys:error_instanceid:
a unique ID for the errorworkflow_instanceid:
the workflow order instance IDstepid:
the stepid where the error was raisedind:
the step array index starting with 0 where the error was raisedseverity:
the severity of the error (see Error Severity Codes for possible values)retry:
1 if the error caused a retryerror:
the string error code for the errordescription:
an optional description of the errorinfo:
an optional string providing additional information about the errorbusiness_error:
a boolean flag indicating if the error is a business errorcreated:
the date/time the error was createdHierarchyInfo:
a hash of workflow order information; the keys are workflow order instance IDs for all workflow orders linked to each other through parent-child relationships in the hierarchy of the current workflow order; the values are order information hashes similar to the top-level of the return value of this APIAuditEvents:
a list of audit information hashesLastModified:
the last modified date/time of the workflow orderactions:
a list of possible actions on the workflownotes:
a list of notes saved against the order; each element is a REST Order Note Hashworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnote:
(required) a string note that gives the reason for breaking the operator lock"OK"
upon successful executionworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnewdata
(*hash<auto>): the new dynamic data for the current workflow order400 Bad Request
: invalid or missing argument403 Forbidden
: access or authorization erroroptions:
(hash) an optional hash of option names and values; if any options are not valid for the workflow, then an exception is raised and the synchronous workflow execution instance is not startedworkflow_instanceid:
the workflow instance ID of the orderstatus:
the status of the workflowdynamicdata:
the dynamic data of the workflow order instance409 Conflict
: SHUTDOWN-IN-PROGRESS
: cannot start new workflows because the system is shutting down403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)orderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagerror_instanceid:
mit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchlimit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)note:
(required) a string note that gives the reason for setting the operator lock"OK"
upon successful executionlimit:
the maximum number of notes to return; if omitted then all notes are returned403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)note
(string): the note to create on the order403 Forbidden
: access or authorization errordate:
(optional) parsed as a date; this is the new scheduled date to set; if not present, then any scheduled date will be removed"OK"
upon successful execution409 Conflict
: SESSION-ERROR
: cannot reschedule workflow data owned by a foreign session409 Conflict
: WORKFLOW-STATUS-ERROR
: only workflows with status OMQ::StatReady or OMQ::StatScheduled or blocked or canceled workflows with original status OMQ::StatReady or OMQ::StatScheduled can be rescheduled409 Conflict
: RESCHEDULE-ERROR
: reschedule failed because workflow order data started processing while the request was being processed403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)steps_updated:
(deprecated) always 0 in this version of Qorussegments_updated:
the number of segments updatedworkflow_updated:
always True in this version of Qorusworkflow_status:
always OMQ::StatRetry in this version of Qoruscached:
True if the workflow data is currently cached409 Conflict
: STATUS-ERROR
: workflow data does not have either OMQ::StatError, OMQ::StatAsyncWaiting, or OMQ::StatRetry status409 Conflict
: SESSION-ERROR
: cannot change status for workflow data managed by another Qorus instance (foreign session ID)409 Conflict
: RETRY-ERROR
: invalid workflow instance ID403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)steps_updated:
number of steps updatedsegments_updated:
number of segments updatedworkflow_status:
always OMQ::StatErrorold_status:
the old workflow data statusqueued_detached_segments:
number of detached segment events queuedqueued_subworkflows:
number of subworkflow events queuedqueued_async_messages:
number of async events queuedqueued_sync_events:
number of workflow synchronization events queuedqueued_async_retries:
number of async events queuedqueued_retries:
number of retry events queuedqueued_fixed_retries:
number of retry events with a fixed retry time queued403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)priority:
the new order priority from 0 - 999; priority 0 is the highest; 999 is the lowest"OK"
upon successful execution409 Conflict
: SESSION-ERROR
: cannot reschedule workflow data owned by a foreign session409 Conflict
: WORKFLOW-STATUS-ERROR
workflows with status OMQ::StatComplete cannot have their priority changed403 Forbidden
: AUTHORIZATION-ERROR
this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)stepid:
(required) the step ID to skipind:
(optional) one or more step array index values to skip (ranges accepted; ex: "1,3,5-7"
); if not present defaults to 0noretry:
(optional) parsed with Qore::parse_boolean(); if True then no retry will be executed409 Conflict
: SKIP-STEP-ERROR
: step is a subworkflow step; step has not been executed in the given workflow order instance; the given workflow instance ID does not exist409 Conflict
: STEP-STATUS-ERROR
: step status does not allow it to be skipped (ex: IN-PROGRESS, COMPLETE)409 Conflict
: SESSION-ERROR
: workflow order instance belongs to another Qorus session403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)noretry
argument is passed as True.newdata
(hash<auto>): the new static data for the current workflow order; must be a non-empty400 Bad Request
: invalid or missing argument403 Forbidden
: access or authorization errorworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnote:
(optional) a string note that gives the reason for removing the operator lock; if not passed, a default note will be added"OK"
upon successful executionorderkeys
(OrderKeySet): the order keys to replace for the current workflow ordertruncate
(*bool): truncate any key values automatically to the length of the column (4000 characters)400 Bad Request
: invalid orderkeys argument403 Forbidden
: access or authorization errorThis REST URI path provides actions and information related to RBAC permissions
list:
optional; parsed with Qore::parse_boolean(); if True then a list of permission names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with permission names and brief info is returnedname:
(required string) the name of the new user permissiondesc:
(required string) the description for the new user permission"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to a specific RBAC permission
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information about Qorus releases
component:
the component name to search for (implies with_files = True
and with_components = True
)component_maxdate:
the upper date range for the release search for component (implies with_files = True
and with_components = True
)component_mindate:
the lower date range for the release search for component (implies with_files = True
and with_components = True
)file_maxdate:
give the upper date range for the release search for files (implies with_files = True
)file_mindate:
give the lower date range for the release search for files (implies with_files = True
)file_name:
the file name to search for; note that this is used with the SQL like operator (implies with_files = True
)limit:
the maximum number of releases to returnmaxdate:
give the upper date range for the release searchmindate:
give the lower date range for the release searchoffset:
the starting release to return (use when paging for example)with_components:
if True then file components are inname:
the name of the releasedescription:
the description of the releasecreated:
the date/time the release was createdmodified:
the date/time the release was last modifiedThis REST URI path provides actions and information about a specific Qorus release
name:
the name of the releasedescription:
the description of the releasecreated:
the date/time the release was createdmodified:
the date/time the release was last modifiedfiles:
a list of file components of the release; each list element is a hash with the following keys:name:
the full file pathtype:
the type of filehash_type:
the type of cryptographic hash for the filehash:
the cryptographic hash value of the filecreated:
the date/time the file entry was created with the releasemodified:
the last modified date/time of the file entrycomponents:
a list of object components created from the file; each list element is a hash with the following keys:component:
the name of the componentversion:
the version of the componentid:
the ID of the component (ex: if type
= "FUNCTION"
, then id
is a function ID)content_id:
the component content IDhash_type:
the type of cryptographic hash for the filehash:
the cryptographic hash value of the filecreated:
the date/time the file entry was created with the releasemodified:
the last modified date/time of the file entryThis REST URI path provides actions and information about remote Qorus, user and datasource connections
"datasources"
: for the /api/remote/datasources"qorus"
: for the /api/remote/qorus"user"
: for the /api/remote/user"qorus"
, user connections under "user"
, and datasource connections under "datasources"
)list:
optional; parsed with Qore::parse_boolean(); if True then a list of connection names is returnedmonitored:
optional; (remote and user connections only) parsed with Qore::parse_boolean(); if True then only monitored connections are returnedremote:
optional; (remote connections) parsed with Qore::parse_boolean(); if True then no loopback connections are returned; default if not present: Falsertime:
optional; (datasource connections only) parsed with Qore::parse_boolean(); if True then the following attributes are returned as relative date/time values:"warning-timeout"
"error-timeout"
"pool-wait-max"
short:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with connection names and brief info is returnedwith_passwords:
(datasource connections only) parsed with Qore::parse_boolean(); if True then the pass
key is returned in the REST Datasource Connection Hash return value and then the calling user must have one of the following permissions:
"conntype"
value determines the hash format as follows:"DATASOURCE"
: a REST Datasource Connection Hash"REMOTE"
or "USER-CONNECTION"
: a REST User and Remote Connection Hash403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationwith_passwords
option is usedThis REST URI path provides actions and information related to Qorus system datasources
list:
optional; parsed with Qore::parse_boolean(); if True then a list of datasource names is returnedrtime:
optional; parsed with Qore::parse_boolean(); if True then the following attributes are returned as relative date/time values:"warning-timeout"
"error-timeout"
"pool-wait-max"
short:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with datasource names and brief info is returnedwith_passwords:
parsed with Qore::parse_boolean(); if True then the pass
key is returned in the REST Datasource Connection Hash elements403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationwith_passwords
argument requires permission OMQ::QR_DATASOURCE_CONTROL or OMQ::QR_READ_DATASOURCEname:
(required) the name of the new datasource"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationinfo:
a string indicating that no action was taken; this API no longer has any function403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationinfo:
a string confirming the reload operation403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to a specific Qorus system datasource
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: DATASOURCE-ERROR
: this exception is thrown if the given datasource does not exist or is a system datasourcertime:
optional; parsed with Qore::parse_boolean(); if True then the following attributes are returned as relative date/time values:"warning-timeout"
"error-timeout"
"pool-wait-max"
with_password:
parsed with Qore::parse_boolean(); if True then the pass
key is returned in the REST Datasource Connection Hash return value403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationwith_password
argument requires permission OMQ::QR_DATASOURCE_CONTROL or OMQ::QR_READ_DATASOURCE"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: DATASOURCE-ERROR
: this exception is thrown if the call tries to modify a locked system datasource or invalid options are passed"min"
and "max"
datasource options must be present to be used; if only one is present, it is ignoredok:
the status of the pingname:
the name of the connectiondesc:
the description of the connectionurl:
the URL for the connectionopts:
a hash of options for the connection (if any)time:
the elapsed time for the pinginfo:
"OK"
if the ping was successful or an error message if not403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to Qorus remote connections
list:
optional; parsed with Qore::parse_boolean(); if True then a list of connection names is returnedmonitored:
optional; parsed with Qore::parse_boolean(); if True then only monitored connections are returnedremote:
optional; parsed with Qore::parse_boolean(); if True then no loopback connections are returned; default if not present: Falseshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with connection names and brief info is returned403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationinfo:
a string confirming the reload operation403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to a specific remote connection
with_password:
(optional bool) include the password in the "url"
and "url_hash"
keys403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationok:
the status of the pingname:
the name of the connectiondesc:
the description of the connectionurl:
the URL for the connectionopts:
a hash of options for the connection (if any)time:
the elapsed time for the pinginfo:
"OK"
if the ping was successful or an error message if not403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to Qorus user connections
list:
optional; parsed with Qore::parse_boolean(); if True then a list of connection names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with connection names and brief info is returned403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationname:
(required string) the name of the user connectiondesc:
(required string) the description for the new user connectionurl:
(required string) the URL for the new user connectionoptions:
(optional hash) a hash of options for the user connection (also "opts"
is accepted as an alias for "options"
)info:
a string confirming the user connection creation403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: USER-CONNECTION-ERROR
: missing or invalid name
, desc
, url
, or options
arguments409 Conflict
: CONNECTION-ERROR
: connection already exists; unknown scheme in URLinfo:
a string confirming the reload operation403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to a specific user connection
info:
a string confirming the delete operation403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationwith_password:
(optional bool) include the password in the "url"
and "url_hash"
keys403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdesc:
(optional string) a new description for the connectionurl:
(optional string) a new URL for the connectionoptions:
(optional hash) new options for the connection; also accepts "opts"
as an alias for this optiontags:
(optional hash) new tags for the connectioninfo:
a string describing the connection update403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: USER-CONNECTION-ERROR
: invalid or unparsable "options"
keyopts
is accepted as an alias for options
ok:
the status of the pingname:
the name of the connectiondesc:
the description of the connectionurl:
the URL for the connectionopts:
a hash of options for the connection (if any)time:
the elapsed time for the pinginfo:
"OK"
if the ping was successful or an error message if not403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to Qorus roles
list:
optional; parsed with Qore::parse_boolean(); if True then a list of role names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings of role names and descriptions is returned403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationrole
(string): the name of the role to adddesc
(string): the description of the roleperms
(*list<string>): a list of permissions to add to the role; note that users must have at least the LOGIN permission to connect to the servergroups
(*list<string>): a list of groups to add to the rolerole
(string): the role nameprovider
(string): the RBAC provider for the roledesc
(string): the role's descriptionhas_default
(bool): if the role has the DEFAULT
group, providing access to all Qorus interfacespermissions
(*list<string>): a list of permissions the role providesgroups
(*list<string>): a list of @rbacgroups "interface groups" the role provides access toworkflows
(*list<RoleWorkflowInfo>): a list of workflow hashes that the group provides access toservices
(*list<RoleServiceInfo>): a list of service hashes that the group provides access tojobs
(*list<RoleJobInfo>): a list of job hashes that the group provides access tomappers
(*list<RoleMapperInfo>): a list of mapper hashes that the group provides access tovmaps
(*list<RoleValueMapInfo>): a list of value map hashes that the group provides access tofsms
(*list<RoleFsmInfo>): a list of fsm hashes that the group provides access topipelines
(*list<RolePipelineInfo>): a list of data pipeline hashes that the group provides access tousers
(*list<string>): a list of local users that have the role; note that users in external RBAC providers (like LADP) are not listed here400 Bad Request
: missing or invalid arguments403 Forbidden
: access or authorization error409 Conflict
: role already existsThis REST URI path provides actions and information related to a specific role
info
(string): a string describing the role deletion action403 Forbidden
: access or authorization error404 Not Found
: unknown rolerole
(string): the role nameprovider
(string): the RBAC provider for the roledesc
(string): the role's descriptionhas_default
(bool): if the role has the DEFAULT
group, providing access to all Qorus interfacespermissions
(*list<string>): a list of permissions the role providesgroups
(*list<string>): a list of @rbacgroups "interface groups" the role provides access toworkflows
(*list<RoleWorkflowInfo>): a list of workflow hashes that the group provides access toservices
(*list<RoleServiceInfo>): a list of service hashes that the group provides access tojobs
(*list<RoleJobInfo>): a list of job hashes that the group provides access tomappers
(*list<RoleMapperInfo>): a list of mapper hashes that the group provides access tovmaps
(*list<RoleValueMapInfo>): a list of value map hashes that the group provides access tofsms
(*list<RoleFsmInfo>): a list of fsm hashes that the group provides access topipelines
(*list<RolePipelineInfo>): a list of data pipeline hashes that the group provides access tousers
(*list<string>): a list of local users that have the role; note that users in external RBAC providers (like LADP) are not listed here403 Forbidden
: access or authorization error404 Not Found
: invalid roledesc
(*string): updated role descriptionperms
(*list<string>): if provided, this list will replace permissions for the role, unless the permission names are preceded by "+"
or "-"
, meaning add or remove a permission from the exiting permission list, respectively (in which case all permissions must be preceded by a "+"
or "-"
)groups
(*list<string>): if provided, this list will replace the group list for the role unless the group names are preceded by "+"
or "-"
, meaning add or remove a group from the group list, respectively (in which case all group names must be preceded by a "+"
or "-"
)desc
(*string): the new description (if provided as an argument)perms
(*list<string>): updated permissions (if provided as an argument)groups
(*list<string>): updated groups (if provided as an argument)400 Bad Request
: missing or invalid arguments403 Forbidden
: access or authorization error404 Not Found
: invalid roletarget
(string): the name of the new cloned roledesc
(string): the description of the new cloned roleperms
(*list<string>): a list of new permissions for the role, if not present, permissions from the source role will be used for the new role; if present this list will define the permissions for the new role, unless the permission names are preceded by "+"
or "-"
, meaning add or remove a permission from the source list, respectively (in which case all permissions must be preceded by a "+"
or "-"
)groups
(*list<string>): a list of new interface groups, if not present, groups from the source role will be used for the new role; if present, this list will replace the source group list unless the group names are preceded by "+"
or "-"
, meaning add or remove a group from the source list, respectively (in which case all group names must be preceded by a "+"
or "-"
)info
(string): a string describing the role deletion action400 Bad Request
: missing or invalid arguments403 Forbidden
: access or authorization error404 Not Found
: invalid source role409 Conflict
: target already existsThis REST URI path provides actions and information related to Qorus services.
status:
one of:"running"
: for only running services (loaded with at least one active thread)"loaded"
: all loaded services (also running services)"unloaded"
: only services not loadedlist:
optional; parsed with Qore::parse_boolean(); if True then a list of service names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with service names and descriptions is returnedtype:
the type of the service; one of:"system"
: for system services"user"
: for user servicesname:
the service nameversion:
the service versionpatch:
the service patch string (if any)desc:
the service descriptionauthor:
the author of the service (if any)serviceid:
the service IDparse_options:
a list of symbolic parse options for the service program container (if any)status:
the status of the service; one of:"loaded"
: loaded but not running"running"
: loaded and running with at least one service thread"unloaded"
: not loadedlog:
the complete path to the service log filethreads:
the number of active threads in the serviceautostart:
boolean value indicating if the service should be autostarted or notmanual_autostart:
boolean flag set if the autostart
value has been changed manually, in which case the manual setting takes precendence over any new definitions loaded with oloadloaded:
date/time the service was loadedmethods:
a list of hashes for each service method; each hash element has the following keys:name:
the name of the methoddesc:
a description of the methodresources:
a REST Service Resource Hash (if any)resource_files:
a list of hashes giving service resource file information (if any); each list element has the following keys:type:
the type code for the service resourcename:
the name of the service resourceoptions:
a hash of options set on the servicegroups:
a list of interface groups that the service belongs to; each list element is a REST Interface Group Hash (may be empty)alerts:
a list of alerts raised against the service; each list element is a REST Alert Hash (may be empty)lib:
a REST Library Object Hashlog_url:
a complete URL to the websocket source for the service logenabled:
a boolean flag indicating if the service is enabled or not; disabled services cannot be loadedconnections:
a list of connection objects that this service depends on; each list element is a REST Connection Dependency Hash (may be empty)ids:
(required) one or more service names or IDs to disable; a comma-separated string will be split into a listarg:
the service ID or namedisabled:
True or Falseserviceid
]: the service IDtype
]: the type of the service; one of:"system"
: for system services"user"
: for user servicesname
]: the service nameversion
]: the service versioninfo:
info about the service enable action or a reason why the request failed; possible failure reasons:"SERVICE-ERROR"
: unknown service, service not accessible409 Conflict
: SERVICE-DISABLE-ERROR
: missing ids
argumentids:
(required) one or more service names or IDs to enable; a comma-separated string will be split into a listarg:
the service ID or nameenabled:
True or Falseserviceid
]: the service IDtype
]: the type of the service; one of:"system"
: for system services"user"
: for user servicesname
]: the service nameversion
]: the service versioninfo:
info about the service enable action or a reason why the request failed; possible failure reasons:"SERVICE-ERROR"
: unknown service, service not accessible409 Conflict
: SERVICE-ENABLE-ERROR
: missing ids
argumentids:
(required) one or more service names or IDs to start; a comma-separated string will be split into a listarg:
the service ID or name (argument for the load operation)loaded:
a boolean giving the result of the operationalready_loaded
]: (only present if loaded
is True) True if the service was already loaded before this call, False if loaded with this callserviceid
]: the service IDtype
]: the type of the service; one of:"system"
: for system services"user"
: for user servicesname
]: the name of the serviceversion
]: the version of the serviceinfo:
information abouit the operation; if the operation failed, a formatted error string will appear here; possible failure reasons:"SERVICE-ERROR"
: the given service cannot be loaded (does not exist, error initializing the service)"SERVICE-ACCESS-ERROR"
: the user does not have the right to access the given service (for more information, see Interface Groups, only possible if Role Based Access Control is enabled)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)ids:
(required) one or more service names or IDs to reload; a comma-separated string will be split into a listload:
(optional) will be evaluated with Qore::parse_boolean(); if True then services not already loaded will be loaded with this call; default @ref False, meaning that services not already loaded will not be loaded by this callarg:
the service ID or name (argument for the load operation)loaded
]: True if the service was already loaded before this call, False if loaded with this callreset
]: True if the service was (re)loadedserviceid
]: the service IDtype
]: the type of the service; one of:"system"
: for system services"user"
: for user servicesname
]: the name of the serviceversion
]: the version of the serviceinfo:
information abouit the operation; if the operation failed, a formatted error string will appear here; possible failure reasons:"SERVICE-ERROR"
: the given service cannot be loaded (does not exist, error initializing the service)"SERVICE-ACCESS-ERROR"
: the user does not have the right to access the given service (for more information, see Interface Groups, only possible if Role Based Access Control is enabled)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SERVICE-RESET-ERROR
: missing ids
argumenttype:
the type of service reset; one of:"system"
: for system services"user"
: for user servicesname:
name of the service403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationtype:
the type of service reset; always "system" for this callname:
name of the service403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationtype:
the type of service reset; always "user" for this callname:
name of the service403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationids:
(required) one or more service names or IDs to unload; a comma-separated string will be split into a listarg:
the service ID or name (argument for the unload operation)loaded
]: True if the service was already loaded, False if notunloaded
]: True if the service was unloaded, False if notserviceid
]: the service IDtype
]: the type of the service; one of:"system"
: for system services"user"
: for user servicesname
]: the name of the serviceversion
]: the version of the serviceinfo:
information abouit the operation; if the operation failed, a formatted error string will appear here; possible failure reasons:"SERVICE-ERROR"
: the given service cannot be loaded (does not exist, error initializing the service)"SERVICE-ACCESS-ERROR"
: the user does not have the right to access the given service (for more information, see Interface Groups, only possible if Role Based Access Control is enabled)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SERVICE-UNLOAD-ERROR
: missing ids
argumentThis REST URI path provides actions and information related to Qorus services; the name can also be provided in the format name:version
.
lib_source:
(optional) parsed with Qore::parse_boolean(); if True, then the source code for all library objects is returnedmethod_source:
(optional) parsed with Qore::parse_boolean(); if True, then the source code for all methods is returned in the body
key in each REST Service Method Hashserviceid:
the service IDtype:
the type of the service; one of:"system"
: for system services"user"
: for user servicesname:
the name of the serviceversion:
the version of the servicedescription:
the description of the service (if any)author:
the author of the service (if any)parse_options:
a list of symbolic parse options for the service program containerautostart:
a boolean value indicating if the service should be autostarted or notmanual_autostart:
a boolean flag set if the autostart
value has been changed manually, in which case the manual setting takes precendence over any new definitions loaded with oloadenabled:
a boolean flag indicating if the service is enabled or not; disabled services cannot be loadedcreated:
the date/time the service was createdmodified:
the date/time the service was last modifiedmappers:
a list of mappers associated with the service (can be NOTHING); each mapper element is a REST Mapper Hashvmaps:
a list of value maps associated with the service (can be NOTHING); each value map element is a REST Value Map Hashlatest:
a boolean flag indicating if the current contextual service is the latest service of its type and namemethods:
a list of REST Service Method Hash elementsgroups:
a list of interface groups that the service belongs to; each list element is a REST Interface Group Hash (may be empty)resource_files:
a list of resource file hashes (if any); each list element is a hash with the following keys:name:
the name of the resourcetype:
the type code for the resourcestatus:
the status of the service; one of:"loaded"
: loaded but not running"running"
: loaded and running with at least one service thread"unloaded"
: not loadedthreads:
the number of threads running in the serviceresources:
a REST Service Resource Hashlog_url:
a complete URL to the websocket source for the service logoptions:
a hash of options set on the serviceconnections:
a list of connection objects that this service depends on; each list element is a REST Connection Dependency Hash (may be empty)alerts:
a list of alerts raised against the service; each list element is a REST Alert Hash (may be empty)state:
a hash of saved service state data (if any); see ServiceApi::saveStateData() for more infoautostart:
changes the autostart value (see PUT /api/services/{id_or_name}?action=setAutostart)reset:
reloads the service (see PUT /api/services/{id_or_name}?action=reset)status:
performs the actions listed below depending on the value of the status
argument as follows:"loaded"
: performs a load (see PUT /api/services/{id_or_name}?action=load)"stopped"
: unloads the service (see PUT /api/services/{id_or_name}?action=unload)enabled:
performs the actions listed below depending on the value of the enabled
argument as follows:400 Bad Request
: invalid or missing arguments to REST calltype:
the service type one of:"system"
: for system services"user"
: for user servicesname:
the service nameversion:
the service versionserviceid:
the service IDinfo:
info about the service disable action403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)type:
the service type one of:"system"
: for system services"user"
: for user servicesname:
the service nameversion:
the service versionserviceid:
the service IDinfo:
info about the service enable action403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)409 Conflict
: SERVICE-ERROR
: the given service cannot be loaded (error initializing the service)"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)409 Conflict
: SERVICE-ERROR
: the given service cannot be loaded (error initializing the service)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)autostart:
(required) the autostart status for the service (parsed with parse_boolean())"OK"
upon successful execution400 Bad Request
: missing "autostart"
hash argument403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)options:
a hash of options to set against the service; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash"OK"
upon successful execution400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SERVICE-OPTION-ERROR
: invalid option for service or option cannot be overridden at the service leveldata:
a hash of new service state data or NOTHING which will clear any data403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)409 Conflict
: SERVICE-ERROR
: the given service cannot be loaded (error initializing the service)Unloads the current service from the system. If the service is running, it is first stopped. Additionally, any outstanding method calls must return before the service can be unloaded.
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)409 Conflict
: SERVICE-NOT-LOADED
: this exception is thrown when the service is not loadedDELETE
stream for the named stream if the service implements that stream.stream:
(required) the name of the stream to openGET
stream for the named stream if the service implements that stream.stream:
(required) the name of the stream to openPUT
stream for the named stream if the service implements that stream.stream:
(required) the name of the stream to openPOST
stream for the named stream if the service implements that stream.stream:
(required) the name of the stream to openUnloads the current service from the system. If the service is running, it is first stopped. Additionally, any outstanding method calls must return before the service can be unloaded.
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: SERVICE-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given service (for more information, see Interface Groups)409 Conflict
: SERVICE-NOT-LOADED
: this exception is thrown when the service is not loadedThis REST URI path provides information about service resource files.
This REST URI path provides information about a particular service resource file.
This REST path provides actions and information about service methods
service_status:
the status of the service; one of:"loaded"
: loaded but not running"running"
: loaded and running with at least one service thread"unloaded"
: not loadedserviceid:
the ID of the serviceservice_name:
the name of the serviceservice_type:
the type of the service; one of:"system"
: for system services"user"
: for user servicesparse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the method arguments; parse_args
takes precedence over args
args
]: any arguments passed here will be used directly as the method arguments403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SERVICE-ERROR
: invalid method call; missing method nameThis REST API path provides actions and information about specific workflow steps
list:
optional; parsed with Qore::parse_boolean(); if True then a list of step names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with step names, versions, and stepids is returnedlist
nor short
options are passed as above).This REST API path provides actions and information about specific workflow steps
functions:
a list of REST Function Hash elements with the following additional key:type:
a string specifying the role the function fulfils for the step; one of:"primary"
: the primary step function"validation"
: the validation function"array"
: the array function"async-end"
: the back end functiondesc:
the step description (as derived from the description of the primary step function)This REST URI path provides actions and information about workflow synchronization events
list:
optional; parsed with Qore::parse_boolean(); if True then a list of workflow synchronization event names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with workflow synchronization event names and brief info is returneddesc:
parsed with Qore::parse_boolean(); if True, return in descending ordereventkey:
the event key valueeventname:
the event type nameid:
one or more event type IDslimit:
max number of rows to returnmaxmodified:
if present, parsed as a date; maximum modified datemodified:
if present, parsed as a date; minimum modified dateoffset:
row offsetposted:
the event posted status (True or False)sort:
a comma-separated string will be split into a list;columns for sorting the resultsThis REST URI path provides actions and information about workflow synchronization event types
desc:
parsed with Qore::parse_boolean(); if True, return in descending ordereventkey:
the event key valueeventname:
the event type namelimit:
max number of rows to returnmaxmodified:
if present, parsed as a date; maximum modified datemodified:
if present, parsed as a date; minimum modified dateoffset:
row offsetposted:
the event posted status (True or False)sort:
a comma-separated string will be split into a list;columns for sorting the resultseventkey:
(required) the workflow synchronization event key403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: POST-ERROR
: missing eventkey
argumentThis REST URI path provides actions and information about a particular workflow synchronization event key
403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information for system functionality
instance-key
: (string) the system instance keysession-id
: (int) the application session idomq-version
: (string) the version of the serverqore-version
: (string) the version of the underlying qore library usedmodules:
(hash) a hash of module info as returned by Qore::get_module_hash()datamodel-version
: (string) the version of the datamodel expected by the serveromq-schema
: (string) "user@dbname"
string for the system "omq"
datasourceomq-driver
: (string) driver name for the system "omq"
datasourceomq-db-version
: (any) database server version for the system "omq"
datasourceomquser-schema
: (string) "user@dbname"
string for the "omquser"
datasourceomquser-driver
: (string) driver name for the "omquser"
datasourceomquser-db-version
: (any) database server version for the "omquser"
datasourcestarttime:
(date) date and time the server was startedhostname:
(string) hostname where the server is runningpid:
(int) PID of the server processthreads:
(int) count of currently active threadsschema-properties
: (hash) hash of actual schema properties (identical to system property domain "omq"
)omq_dir:
(string) the application directory or "LSB"
for Linux Standard Base filesystem integrationlogfile:
(string) path to system log filehttp_logfile:
(string) path to system HTTP server log filemonitoring_logfile:
(string) path to system monitoring log filealert_logfile:
(string) path to system alert log filecache_size:
(int) the current size of the workflow order data cacheshutting_down:
(bool) a flag if the system is shutting downbuild-type
: (string) the type of build of the server ("Production"
or "Debug"
)runtime-properties
: (hash) a hash of runtime propertiesalert-summary
: (hash) a hash with the following keys:transient:
(int) number of transient alertsongoing:
(int) number of ongoing alertsdebug:
system debugging flag (when True then more information is provided with exceptions)health:
a string color code for the health of the system with the following values:"GREEN"
: good health"YELLOW"
: warning"RED"
: problemssystem_log_url:
a URL to the websocket source for the main system logaudit_log_url:
a URL to the websocket source for the audit loghttp_log_url:
a URL to the websocket source for the HTTP server logmon_log_url:
a URL to the websocket source for the monitoring logalert_log_url:
a URL to the websocket source for the alert log"OK"
403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationtimeout:
(optional) a timeout in seconds; the currently running system will be killed if it does not shut down within this time period; if not given, the default timeout is 2 minutes (120 seconds)"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationqorus-log-rotator
service to rotate log files instead of calling this API method directly.403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationflag:
(optional) parsed with Qore::parse_boolean(); if True then system debugging is enabled, if False, then it is disabled; default value if not present: Truesystem-debugging
: the system debugging setting as a boolean value403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SHUTDOWN-ALREADY-IN-PROGRESS
: system shutdown is already in progress403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationstream:
(optional) the name of the stream to return; can be:"DataStream"
: returns a short output DataStream of lists of hashes"EchoDataStream"
: returns an input/output DataStream where the input is immediately returned as outputstream:
(optional) the name of the stream to return; can be:"DataStream"
: returns a short output DataStream of lists of hashes"EchoDataStream"
: returns an input/output DataStream where the input is immediately returned as outputstream:
(optional) the name of the stream to return; can be:"DataStream"
: returns a short output DataStream of lists of hashestoken
(string): the token string400 Bad Request
: missing "token"
argument or invalid argument type409 Conflict
: TOKEN-ERROR
: invalid tokenQorus-Token
header to provide authentication for future requests up to the lifetime of the token. Tokens are valid only for the current session; to use persistent, long-lived tokens, please use OAuth2 authentication instead. The maximum token duration is 2 days; longer durations will be capped to 2 days.ttl
(*int): duration of validity of the token in seconds; if not present, defaults to 10 minutesQorus-Token
headerThis REST URI path provides actions and information related to system alerts
remote:
(optional) the name of a remote Qorus connection to retrieve alerts for and add to the return valuesummary:
(optional) parsed with Qore::parse_boolean(); if True the return value is a hash with the following keys:"cutoff"
: the transient cut off date used"transient"
: the count of transient alerts"ongoing"
: the count of ongoing alertscutoff:
(optional) parsed as a date; the cutoff date/time for transient alerts (only used when summary
is True); transient events after this point in time are not considered in the summarized resultsummary
option is passed (see above for details)This REST URI path provides actions and information related to ongoing system alerts
remote:
(optional) the name of a remote Qorus connection to retrieve ongoing alerts for and add to the return valueThis REST URI path provides actions and information related to transient system alerts
remote:
(optional) the name of a remote Qorus connection to retrieve transient alerts for and add to the return valuemax:
(optional) the maximum number of local alerts to return; defaults to 50 if not givenThis REST URI path provides actions and information about the system RPC API
method:
(required) the string method name to call; if no "."
characters are found in the method name, then it is prefixed with "omq.system."
; if the method starts with "system."
or "user."
, then "omq."
is prefixed to the method; if the method starts with "group."
or "job."
, then "omq.system."
is prefixed to the method nameparse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the method arguments; parse_args
takes precedence over args
args
]: any arguments passed here will be used directly as the method arguments409 Conflict
: API-ERROR
: missing or invalid "method"
keyThis REST URI path provides actions and information about system health
transient:
the number of transient alertsongoing:
the number of ongoing alertshealth:
a string color code for the health of the system with the following values:"GREEN"
: good health"YELLOW"
: warning"RED"
: problemsinstance-key
: the instance key for the systemremote:
a list of health information for remotely-monitored Qorus instances with the same keys as this hash (minus "remote"
)hash: (5 members) transient : 0 ongoing : 123 health : "RED" instance-key : "quark-1" remote : <EMPTY LIST>
This REST URI path provides actions and information related to Qorus HTTP listeners
name
(string): the unique name of the listenerhostname
(*string): the bind hostnamehostname_desc
(*string): a description for the hostnameaddress
(string): the bind addressaddress_desc
(string): a description for the addressport
(*int): the port number (not present in UNIX sockets)family
(int): the network address family code for the socketfamilystr
(string): a descriptive string for the family
codessl
(bool): True if the listener is a TLS/SSL listenerdesc
(string): a descriptive string for the listenerproto
(string): the protocol; either "http"
or "https"
id
(int): the listener IDbind
(string): the bind stringget_remote_certs
(bool): flag if remote client certificates will be capturedssl_verify_flags
(list<string>): SSL verification flags (see SSL Verification Mode Constants for the meaning of these values)ssl_accept_all_certs
(bool): if the listener will accept all client certificates (verification disabled) or not (verification enabled)bind:
the bind address of the new listener; listeners will be started on all possible bind addresses in case more than one interface is resolved from the bind address givencert_file
]: (optional) the file name of the X.509 certificate in PEM format (only for HTTPS listeners)key_file
]: (optional) the file name of the private key for the X.509 certificate in PEM format (only for HTTPS listeners)key_password
]: (optional) the password to the private key, if anyfamily
]: (optional) the integer network address family code or symbolic string namename
]: (optional) the name of the listener; if not provided a unique name will be generatedhostname
, hostname_desc
, and port
keys will not be present):hostname:
the hostname of the interfacehostname_desc:
a descriptive string for the hostname including the address family (ex: "ipv6[localhost]"
)address:
the address of the listener (i.e. "192.168.30.4"
, etc)address_desc:
a descriptive string for the hostname including the address family (ex: "ipv6[::1]"
)port:
the port numberfamily:
an integer giving the address family (AF_INET
, AF_INET6
, AF_UNIX
, etc)familystr:
a string describing the address family (ex: "ipv6"
)proto:
either "http"
or "https"
id:
the Qorus ID of the listenerbind:
a string giving the bind address used (ex: "127.0.0.1:8001"
)400 Bad Request
: if no listeners can be started, then the message body in the response gives403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to a specific HTTP listener
"OK"
upon successful execution400 Bad Request
: LISTENER-ARG-ERROR
: cannot stop a listener via a request handled by the same listener403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationname
(string): the unique name of the listenerhostname
(*string): the bind hostnamehostname_desc
(*string): a description for the hostnameaddress
(string): the bind addressaddress_desc
(string): a description for the addressport
(*int): the port number (not present in UNIX sockets)family
(int): the network address family code for the socketfamilystr
(string): a descriptive string for the family
codessl
(bool): True if the listener is a TLS/SSL listenerdesc
(string): a descriptive string for the listenerproto
(string): the protocol; either "http"
or "https"
id
(int): the listener IDbind
(string): the bind stringget_remote_certs
(bool): flag if remote client certificates will be capturedssl_verify_flags
(list<string>): SSL verification flags (see SSL Verification Mode Constants for the meaning of these values)ssl_accept_all_certs
(bool): if the listener will accept all client certificates (verification disabled) or not (verification enabled)flag:
(optional) if present, parsed with Qore::parse_boolean(); if True then verbose logging is enabled for the current listener, if False, then it is disabled; default value if not present True"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationoption
argument passedoption:
(required) an integer product of Listener Log Options combined with binary or"OK"
upon successful execution400 Bad Request
: missing "option"
argument403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation400 Bad Request
: LISTENER-ARG-ERROR
: cannot stop a listener via a request handled by the same listener403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to the system metadata cache
workflows:
a list of workflow IDs to reload in the metadata cache and resetservices:
a list of service IDs to reload in the metadata cache and to resetjobs:
a list of job IDs to reload in the metadata cache and to resetmappers:
a list of mapper IDs to reload in the metadata cachevmaps:
a list of value map IDs to reload in the metadata cachefunctions:
a list of functions IDs to reload in the metadata cacheclasses:
a list of class IDs to reload in the metadata cacheconstants:
a list of constant IDs to reload in the metadata cachequeues:
a list of queue IDs to reload in the metadata cacheevents:
a list of event IDs to reload in the metadata cachesteps:
a list of step IDs to reload in the metadata cacheconfig_values:
a list of config item names to reload in the metadata cachetypes:
a list of type paths to reload in the metadata cacheworkflows:
the number of workflows updated in the metadata cacheservices:
the number of services updated in the metadata cachejobs:
the number of jobs updated in the metadata cachemappers:
the number of mappers updated in the metadata cachevmaps:
the number of value maps updated in the metadata cachefunctions:
the number of functions updated in the metadata cacheclasses:
the number of classes updated in the metadata cacheconstants:
the number of constants updated in the metadata cachequeues:
the number of queues updated in the metadata cacheevents:
the number of events updated in the metadata cachesteps:
the number of steps updated in the metadata cacheconfig_values:
the number of configuration item values updated in the metadata cacheworkflow_reset:
a hash of workflow reset info; see the return value of PUT /api/workflows?action=reset for a description of this hashservice_reset:
a hash of service reset info; see the return value of PUT /api/services?action=reset for a description of this hashjob_reset:
a hash of job reset info; see the return value of PUT /api/jobs?action=reset for a description of this hashtypes:
the number of types in the metadata cache409 Conflict
: METADATA-RELOAD-ERROR
: unknown metadata keys passedworkflows:
requires OMQ::QR_WORKFLOW_CONTROL, OMQ::QR_WORKFLOW_EXEC_CONTROL, or OMQ::QR_RESET_WORKFLOWservices:
requires OMQ::QR_SERVICE_CONTROL or OMQ::QR_RESET_SERVICEjobs:
requires OMQ::QR_JOB_CONTROL or OMQ::QR_RESET_JOBmappers:
requires OMQ::QR_MAPPER_CONTROL or OMQ::QR_RELOAD_MAPPERvmaps:
requires OMQ::QR_VALUE_MAP_CONTROL or OMQ::QR_RELOAD_VALUE_MAPtypes:
requires OMQ::QR_TYPE_CACHE_CONTROL or OMQ::QR_TYPE_CACHE_RELOADThis REST URI path provides actions and information related to system options; see System Options for more information
hash:
optional (parsed with Qore::parse_boolean()); if True then the return type is a hash keyed by option name instead of a listhash
argument is not set; each element in the list is a REST System Option Hashoptions:
a hash of options; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash"OK"
upon successful execution400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())409 Conflict
: OPTION-ERROR
: one or more options given was invalid or could not be setThis REST URI path provides actions and information related to specific system options; see System Options for more information
value:
(required) the new value for the option"OK"
upon successful execution400 Bad Request
: missing "value"
argument409 Conflict
: OPTION-ERROR
: there was an error setting the optionThis REST URI path provides actions and information related to a system properties.
domain:
(optional) a system property domain to retrieve values forkey:
(optional) a system property key in the given domain; if key
is given then domain
must also be passeddomain
value is passeddomain
value is passed and the domain exists, otherwise NOTHINGdomain
and key
values are passed and the property exists"qorus_properties"
tag are only informational and are not used when importing. The "omq"
domain is not exported."omq"
domain.{qorus_properties: {domain1: {key1: "value", key2: "value"}, ^attributes^: {instance: "quark-1", schema-version: "3.1.0", schema-compatibility: "3.1.0", schema-load-compatibility: "3.1.0"}}}
domains:
(optional) a list of domains to import; a comma-separated string will be split into a list"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdomain:
(required) a string giving the system property domain for the key-value pairkey:
(required) a string giving the property key value in the given domainparse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the property value; parse_args
takes precedence over args
args
]: arguments passed here will be used directly as the system property value"INSERT"
: the property was created"UPDATE"
: the property was updated"DELETE"
: the property was deleted (existing key, no value passed)"IGNORED"
: if a non-existent key should be deleted403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: SYSTEM-PROPERTY-ERROR
: the given key already exists in the given property domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)arg:
(required) must be a hash in the format domain.key.value
for updating, inserting, or deleting"INSERT"
, "UPDATE"
, "DELETE"
and "IGNORED"
keys with integer values corresponding to the number of operations performed (deleting a non-existent key or domain causes a "IGNORED"
value to be returned).403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)This REST URI path provides actions and information related to a specific system property domain.
"DELETE"
(and "IGNORED"
keys in case of a race condition with a competing delete operation on the same system property domain) with integer values corresponding to the number of operations performed.403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domainkey:
(optional) one or more property values in the domain to return; if the string is a comma-separated list, it will be interpreted as a list of keyskey
argument as above)arg:
(required) a hash giving all key-value pairs for the new system property domain"INSERT"
(and "UPDATE"
in case of a race condition with a parallel request writing to the same system property domain) keys with integer values corresponding to the number of operations performed403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: SYSTEM-PROPERTY-ERROR
: the given key already exists in the given property domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)key:
(required) a string giving the property key value in the current domainparse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the property value; parse_args
takes precedence over args
args
]: arguments passed here will be used directly as the system property value"INSERT"
: the property was created"UPDATE"
: the property was updated"DELETE"
: the property was deleted (existing key, no value passed)"IGNORED"
: if a non-existent key should be deleted403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)arg:
(required) a key-value hash for updating, inserting, or deleting system properties in the current domain"INSERT"
, "UPDATE"
, "DELETE"
and "IGNORED"
keys with integer values corresponding to the number of operations performed (deleting a non-existent key or domain causes a "IGNORED"
value to be returned).403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)This REST URI path provides actions and information related to a specific system property key.
"DELETE"
: the property was deleted"IGNORED"
: if a non-existent key should be deleted (only possible with this API with a race condition where the property was deleted in another thread during this request)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domainparse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the property value; parse_args
takes precedence over arg
arg
]: the argument passed here will be used directly as the system property value"INSERT"
: the property was created"UPDATE"
: the property was updated (only possible with this API with a race condition where the property was created in another thread during this request)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: SYSTEM-PROPERTY-ERROR
: the given key already exists in the given property domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)parse_args
]: any string here will be parsed with Util::parse_to_qore_value() and used as the property value; parse_args
takes precedence over args
args
]: arguments passed here will be used directly as the system property value"INSERT"
: the property was created (only possible with this API with a race condition where the property was deleted in another thread during this request)"UPDATE"
: the property was updated"DELETE"
: the property was deleted (existing key, no value passed)"IGNORED"
: if a non-existent key should be deleted (only possible with this API with a race condition where the property was deleted in another thread during this request)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: UPDATE-ERROR
: changes attempted in the "omq"
domain409 Conflict
: PROP-ERROR
: serialized value exceeds 4000 bytes (column limit)loaded:
the date/time Role Based Access Control information was loadedusers:
the number of users cachedroles:
the number of roles cachedpermissions:
a list of REST Permission Hash elementsenabled:
True if Role Based Access Control is enabledgroups:
the number of interface groups cachedproviders:
a hash of providers keyed by descriptive name; values are hashes with the following keys:loaded:
the date/time the provider was loadedstorage:
a boolean value indicating whether the provides supports user-defined storage or not"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information related to Qorus application sessions
ended_maxdate:
(optional) give the upper date range for the session end dateended_mindate:
(optional) give the lower date range for the session end datehostname:
(optional) the hostname to search forid:
(optional) the session IDkey:
(optional) the instance key namelimit:
(optional) the maximum number of sessions to returnlist:
(optional) parsed with Qore::parse_boolean(); if True then a list of session names is returnedshort:
(optional) parsed with Qore::parse_boolean(); if True then a list of short strings of session names and descriptions is returnedstarted_maxdate:
(optional) give the upper date range for the session start datestarted_mindate:
(optional) give the lower date range for the session start dateoffset:
(optional) the starting release to return (use when paging for example)status:
(optional) one or more session status valuesurl:
(optional) the HTTP URL for the instanceversion:
(optional) the Qorus version stringlist
and short
are not used, then this API returns list of hashes for sessions matched; each hash has the following keys:id:
the session IDkey:
the instance key for the sessionstatus:
status of the sessionhostname:
the hostname hosting the Qorus process running the sessionurl:
the primary URL for the application sessionversion:
the Qorus version for the sessionstarted:
the date/time the session startedended:
the date/time the session endedThis REST API path provides actions and information related to the system SQL cache
system:
returns information about system objects as well (in the "omq"
datasource)count:
the number of times accessedcreated:
the date/time the object was cacheddatasource:
(optional) a string giving the datasource to clear all objects forname:
(optional) the name of the object to clear; if this argument is given, then datasource
must also be given"OK"
upon successful executionThis REST URI path provides actions and information related to the system UI
This REST URI path provides actions and information related to system UI extensions
This REST URI path provides actions and information related to a specific system UI extension
This REST URI path provides actions and information about user HTTP services.
title:
the title of the HTTP serviceurl:
the full URL to the serviceservice:
the name of the serviceversion:
the version of the serviceserviceid:
the service IDThis REST URI path provides actions and information related to Qorus users
list:
optional; parsed with Qore::parse_boolean(); if True then a list of user names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings of user names and descriptions is returned403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationusername:
(required) the username to addpass:
(required) the password for the username:
(required) the name of the userroles:
(optional) a single role or a list of roles to add to the user; note that the user must have at least the OMQ::QR_LOGIN permission to connect to the server403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: RBAC-ADD-USER-ERROR
: invalid user, invalid role, invalid groupuser
is also accepted as an alias for username
desc
is also accepted as an alias for name
This REST URI path provides actions and information related to a particular user
info:
a string describing the user deletion action403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationpass:
(string) passwordname:
(string) user descriptionstorage:
(hash) updated key-value pairs for server-side user storage; set a key to NOTHING to delete the keyroles:
(list of strings) a comma-separated string will be split into a list; the new list will replace the current list unless the role names are preceded by "+"
or "-"
, meaning add or remove a role, respectively (in which case all role names must be preceded by a "+"
or "-"
); to remove all roles for a user, send an empty list here403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: RBAC-UPDATE-USER-ERROR
: invalid user, no valid keys in hash, invalid roleThis URI path provides actions and information related to Qorus value maps
list:
optional; parsed with Qore::parse_boolean(); if True then a list of value map names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with value map names and brief info is returned403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)ids:
(required) a comma-separated string will be split into a list; the value map names or IDs to reset"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)409 Conflict
: VALUE-MAP-ERROR
: invalid or unknown value map"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis URI path provides actions and information related to a specific value map
403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)key:
(required) the value map key to look up403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)409 Conflict
: VALUEMAP-LOOKUP-ERROR
: missing key
argument key"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)key:
(required) the value map key to create or updatevalue:
(optional) the value to set; if not present, then the given key will be deletedenabled:
(optional) parsed with Qore::parse_boolean(); if True then the key is immediately usable; if not present the default is False"DELETED"
: the key was deleted"IGNORED"
: the key to be deleted did not exist"CREATED"
: the key-value pair was created"UPDATED"
: the key-value pair was updated403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)This URI path provides actions and information related to a specific value map value
403 Forbidden
: VALUEMAP-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given value map (for more information, see Interface Groups)This URI path allows workflows to be queried and for actions on multiple workflows to be performed; this is the URI path parent of workflow-specific actions as well.
deprecated:
optional; parsed with Qore::parse_boolean(); if False then no deprecated workflows will be returned; default Truelist:
optional; parsed with Qore::parse_boolean(); if True then a list of workflow names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings of workflow names and descriptions is returneddate:
optional; parsed as a date; the minimum date for historical workflow order overview information; if omitted then defaults to the past 24 hourssqlcache:
optional; parsed with Qore::parse_boolean(); if False then no SQL cache will be used for historical info; default Trueids:
(required) one or more workflow names or IDs to modify; a comma-separated string will be split into a listarg:
the workflow ID or nameupdated:
True or Falseautostart:
the new autostart value for the workflowworkflowid
]: the workflow IDname
]: the workflow nameversion
]: the workflow versioninfo:
info about the workflow update action or a reason why the request failedstopped
]: the number of execution instances stopped409 Conflict
: WORKFLOW-SETAUTOSTART-ERROR
: missing ids
argument; autostart value cannot be negativeids:
(required) one or more workflow names or IDs to disable; a comma-separated string will be split into a listcount:
number of workflow execution instances disableddetails:
a list of hashes providing details of the individual workflow disable actions with the following keys
409 Conflict
: WORKFLOW-DISABLE-ERROR
: missing ids
argumentids:
(required) one or more workflow names or IDs to enable; a comma-separated string will be split into a list409 Conflict
: WORKFLOW-ENABLE-ERROR
: missing ids
argument409 Conflict
: SHUTDOWN-IN-PROGRESS
: disabled workflows cannot be enabled while the system is shutting downids:
(required) one or more workflow names or IDs to modify; a comma-separated string will be split into a listarg:
the workflow ID or nameupdated:
True or Falseautostart:
the new autostart value for the workflowworkflowid
]: the workflow IDname
]: the workflow nameversion
]: the workflow versioninfo:
info about the workflow update action or a reason why the request failedstarted
]: the number of execution instances started409 Conflict
: WORKFLOW-SETAUTOSTART-ERROR
: missing ids
argument; cannot set a positive autostart value on a workflow with the deprecated flag setorderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagworkflow_instanceid:
limit the search to one or more workflow_instanceidserror_instanceid:
mit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchworkflowid:
limit the search to one or more workflowidsworkflowstatus:
limit the search to workflow instances with the given status value(s)limit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)mindate:
(required) minimum datemaxdate:
maximum datewfids:
optional workflow IDsseconds:
if True then the performance values will be returned as arbitrary-precision numeric values representing seconds, otherwise they will be returned as relative date/time valuesglobal:
if True then all workflows will be combined into an overall processing report, if False then each workflow gets a separate line in the output"hourly"
: hourly grouping"daily"
: daily grouping"monthly"
: monthly grouping"yearly"
: yearly groupingworkflowid:
the workflow IDname:
the workflow nameversion:
the workflow versioncount:
the number of workflow orders in the periodminstarted:
the minimum workflow order start datemaxcompleted:
the maximum workflow order completion date (if any)minduration:
the minimum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)avgduration:
the average total elapsed order processing time for workflow orders in the period (starting from workflow order creation)maxduration:
the maximum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)minprocessing:
the minimum order processing time for workflow orders in the period (starting from when then order was first processed)avgprocessing:
the average order processing time for workflow orders in the period (starting from when then order was first processed)maxprocessing:
the maximum order processing time for workflow orders in the period (starting from when then order was first processed)409 Conflict
: ARGUMENT-ERROR
: missing mindate
ids:
(required) one or more workflow names or IDs to reset; a comma-separated string will be split into a listcount:
number of workflow execution instances disableddetails:
a list of hashes providing details of the individual workflow reset actions with the following keys
409 Conflict
: WORKFLOW-RESET-ERROR
: missing ids
argumentname:
the name of the workflow that was resetversion:
the version of the workflow that was resetworkflowid:
the workflow ID of the workflow that was resetcount:
the number of workflow execution instances affectedids:
(required) one or more workflow names or IDs to modify; a comma-separated string will be split into a listautostart:
(required) an integer value giving the new autostart value for the workflow(s)started
409 Conflict
: WORKFLOW-SETAUTOSTART-ERROR
: missing ids
or autostart
argument; autostart
value is negative; cannot set a positive autostart value on a workflow with the deprecated flag setids:
(required) one or more workflow names or IDs to modify; a comma-separated string will be split into a listdeprecated:
(required) a value (processed with Qore::parse_boolean()) indicating whether or not the workflows should have their deprecated flag set (True) or removed (False)arg:
the workflow ID or nameupdated:
True or Falseworkflowid
]: the workflow IDname
]: the workflow nameversion
]: the workflow versionstopped
]: a hash keyed by workflow description where the values are the lists of all execution instance IDs stopped for that workflowinfo:
info about the workflow update action or a reason why the request failed409 Conflict
: WORKFLOW-SETDEPRECATED-ERROR
: missing ids
or deprecated
argument409 Conflict
: SHUTDOWN-IN-PROGRESS
: disabled workflows cannot be enabled while the system is shutting downids:
(required) one or more workflow names or IDs to start; a comma-separated string will be split into a list409 Conflict
: WORKFLOW-START-ERROR
: missing ids
argument409 Conflict
: SHUTDOWN-IN-PROGRESS
: workflows cannot be started while the system is shutting downids:
(required) one or more workflow names or IDs to stop; a comma-separated string will be split into a listcount:
number of workflow execution instances stoppedworkflows:
a hash keyed by workflow description where the values are the lists of all execution instance IDs stopped for that workflowdetails:
a list of hashes providing details of the individual workflow stop actions with the following keys
409 Conflict
: WORKFLOW-STOP-ERROR
: missing ids
argumentcount:
number of workflow execution instances stoppedworkflows:
a hash keyed by workflow description where the values are the lists of all execution instance IDs stopped for that workflowmsg:
a descriptive message about the workflows stoppedThis REST URI path provides actions and information about a particular workflow.
staticdata
]: the static data for the order; either this key or external_order_instanceid
is requiredexternal_order_instanceid
]: the external order instance ID for the workflow data; either this key or staticdata
is requireddynamicdata
]: the initial dynamic data for the orderorderkeys
]: a hash of order keys for the orderscheduled
]: the earliest date and time the order can be processed; if this date is given as a future date/time value and a OMQ::StatReady status is given, then the initial status of the workflow order data instance will be automatically changed to OMQ::StatScheduled instead of OMQ::StatReadypriority
]: the order priority (default OMQ::DefaultOrderPriority) from 0 - 999; priority 0 is the highest; 999 is the loweststatus
]: the initial order status (default OMQ::StatReady); must be either OMQ::StatReady or OMQ::StatBlockedparent_workflow_instanceid
]: a loosely-coupled workflow that will be marked as the parent of this workflowworkflow_instanceid
the workflow instance ID of the workflow order instance ID created403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationupdated
(bool): a flag indicating if a change was actually made or notautostart
(int): the new autostart valueinfo
(string): a string providing information about the workflow update actionstarted
(int): if negative, then it is the number of execution instances stopped403 Forbidden
: access or authorization error409 Conflict
: exception processing the requestworkflowid
(int): the workflow IDname
(string): the workflow nameversion
(string): the workflow versioninfo
(string): a string providing information about the workflow update action403 Forbidden
: access or authorization errorworkflowid
(int): the workflow IDname
(string): the workflow nameversion
(string): the workflow versioninfo
(string): a string providing information about the workflow update action403 Forbidden
: access or authorization error409 Conflict
: exception processing the requeststaticdata
]: the static data for the order; either this key or external_order_instanceid
is requiredexternal_order_instanceid
]: the external order instance ID for the workflow data; either this key or staticdata
is requireddynamicdata
]: the initial dynamic data for the orderorderkeys
]: a hash of order keys for the orderpriority
]: the order priority (default OMQ::DefaultOrderPriority) from 0 - 999; priority 0 is the highest; 999 is the lowestparent_workflow_instanceid
]: a loosely-coupled workflow that will be marked as the parent of this workflowoptions
]: (hash) an optional hash of option names and values; if any options are not valid for the workflow, then an exception is raised and the synchronous workflow execution instance is not startedworkflow_instanceid:
the workflow instance ID of the orderstatus:
the status of the workflowdynamicdata:
the dynamic data of the workflow order instance403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SHUTDOWN-IN-PROGRESS
: cannot start new workflows because the system is shutting downupdated
(bool): a flag indicating if a change was actually made or notautostart
(int): the new autostart valueinfo
(string): a string providing information about the workflow update actionstarted
(int): if negative, then it is the number of execution instances stopped403 Forbidden
: access or authorization error409 Conflict
: exception processing the requestorderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagworkflow_instanceid:
limit the search to one or more workflow_instanceidserror_instanceid:
mit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchworkflowstatus:
limit the search to workflow instances with the given status value(s)limit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)"OK"
403 Forbidden
: access or authorization errorautostart
(int): the new autostart value for the workflowupdated
(bool): a flag indicating if a change was actually made or notautostart
(int): the new autostart valueinfo
(string): a string providing information about the workflow update actionstarted
(int): if negative, then it is the number of execution instances stopped403 Forbidden
: access or authorization error409 Conflict
: exception processing the requestdeprecated:
(required) a value (processed with Qore::parse_boolean()) indicating whether or not the workflow should have its deprecated flag set (True) or removed (False)403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: WORKFLOW-SETDEPRECATED-ERROR
: missing deprecated
argument409 Conflict
: SHUTDOWN-IN-PROGRESS
: disabled workflows cannot be enabled while the system is shutting downoptions:
a hash of options to set against the workflow; if the value of this key is a string, then it is first parsed with Util::parse_to_qore_value(), which should then return a hash"OK"
upon successful execution400 Bad Request
: missing "options"
argument or "options"
is not a hash (or string parsed to a hash with Util::parse_to_qore_value())403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: WORKFLOW-OPTION-ERROR
: invalid option for workflow or option cannot be overridden at the workflow levelcount:
(optional) the number of execution instances to start; defaults to 1mode:
(optional) the workflow execution instance mode; defaults to OMQ::WM_Normal (also may be OMQ::WM_Recovery)name:
the workflow nameversion:
the workflow versionids:
the execution IDs startedexec:
a list of execution instance hashes running for this workflow403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation409 Conflict
: SHUTDOWN-IN-PROGRESS
: cannot start new workflows because the system is shutting down"OK"
upon successful execution403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationThis REST URI path provides actions and information about workflow order data instance errors for a particular workflow.
errors:
optional; a comma-separated string will be split into a list; the workflow-specific workflow errors for the current workflow to returnlist:
optional; parsed with Qore::parse_boolean(); if True then a list of error names is returnedshort:
optional; parsed with Qore::parse_boolean(); if True then a list of short strings with error names and brief info is returnedbusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)forceworkflow:
(optional) parsed with Qore::parse_boolean(); if True then the workflow error will be created as a workflow-specific error even if no global error exists; default if not present Falseretry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)409 Conflict
: ERROR-EXISTS
: this exception is thrown if the workflow-specific error definition already existsforceworkflow
option as described abovebusiness_flag:
(optional bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)description:
(required string) the description of the errorerror:
(required string) the error string (ex: "SOCKET-SSL-ERROR"
)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)retry_flag:
(optional bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)severity:
(optional string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codes"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition"CREATED-GLOBAL"
: a new global error was created (only possible if forceworkflow
is omitted or False)"UNCHANGED-GLOBAL"
: the new global definition is identical to the old definition (only possible if forceworkflow
is omitted or False)403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)forceworkflow
option as described aboveThis URI path provides actions and information related to a workflow-specific workflow error
"OK"
upon successful execution403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operationdescription:
(string) the new description of the errorseverity:
(string) a severity code for the error (if not present OMQ::ES_Major is assumed); for possible values see Error Severity Codesretry_flag:
(bool) parsed with Qore::parse_boolean(); a retry flag value (if not present then False is assumed)business_flag:
(bool) parsed with Qore::parse_boolean(); a boolean business flag value (if not present then False is assumed)retry_delay_secs:
(optional int) an optional retry value in seconds (only used if retry_flag
is also True)"UPDATED-WORKFLOW"
: the existing workflow-specific error was updated"CREATED-WORKFLOW"
: a new workflow-specific error definition was created (only possible in case of a race condition where the current error was deleted during this request)"UNCHANGED-WORKFLOW"
: the new workflow-specific definition is identical to the old definition403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)This REST URI path provides actions and information about workflow execution instances for a particular workflow.
alerts:
a list of alerts raised against the workflow; each list element is a REST Alert Hash (may be empty)log_url:
a complete URL to the websocket source for the workflow logThis REST URI path provides actions and information about workflow orders for the current workflow.
date:
an alternate key for modified
desc:
return in descending orderids:
an alternate key for workflow_instanceid
keyname:
the name of a search key to be used with the keyvalue value(s)keyvalue:
the value(s) of workflow order search key(s) to use (optionally used in conjunction with keyname)limit:
max number of rows to return, if not given, then the value of the "row-limit" option is used (default: 100)maxmodified:
maximum modified datemaxstarted:
maximum start dateminstarted:
minimum start datemodified:
minimum modified dateoffset:
row offsetsort:
columns for sorting the resultsstatus:
status value(s) (see Workflow, Segment, and Step Status Descriptions for possible values)statuses:
an alternate key for status
workflow_instanceid:
workflow_instanceid values(s)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow order instance IDworkflowid:
the workflow IDworkflowstatus:
the status of the workflow order instance (see Workflow, Segment, and Step Status Descriptions for possible values)status_sessionid:
the application session ID that owns the workflow order instance data or 0 if the data is now owned by any application sessionstarted:
the start date/time of the workflow order instancecompleted:
the completed date/time for the workflow order instancemodified:
the last modified date/time of the workflow order instanceparent_workflow_instanceid:
the parent workflow order ID if presentsynchronous:
if 1, indicates that the order is being executed synchronouslybusiness_error:
a boolean flag indicating if the workflow order has an error status due to a business erroroperator_lock:
a string giving the username of the user with an operator lock on the ordernote_count:
the number of notes stored against the orderwarning_count:
the number of warnings raised against the ordererror_count:
the number of errors raised against the ordercustom_status:
a custom status for the orderpriority:
the priority of the workflow orderscheduled:
the future scheduled date of the workflow order (if any)custom_status_desc:
a description for the custom status (if any)actions:
a list of possible actions on the workfloworderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagworkflow_instanceid:
limit the search to one or more workflow_instanceidserror_instanceid:
mit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchworkflowid:
limit the search to one or more workflowidsworkflowstatus:
limit the search to workflow instances with the given status value(s) (see Workflow, Segment, and Step Status Descriptions for possible values)limit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow order (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)date:
optional (parsed as a date); the past cutoff date for the search; only orders with a modified
date equal or after this date will be considered; if not present, then defaults to the last 24 hourssqlcache:
optional (parsed with Qore::parse_boolean()); if False then no SQL cache will be used for historical info; default TrueTOTAL:
the total number of orders matchedmindate:
(required) minimum datemaxdate:
maximum dateseconds:
if True then the performance values will be returned as arbitrary-precision numeric values representing seconds, otherwise they will be returned as relative date/time valuesglobal:
if True then all workflows will be combined into an overall processing report, if False then each workflow gets a separate line in the output"hourly"
: hourly grouping"daily"
: daily grouping"monthly"
: monthly grouping"yearly"
: yearly groupingworkflowid:
the workflow IDname:
the workflow nameversion:
the workflow versioncount:
the number of workflow orders in the periodminstarted:
the minimum workflow order start datemaxcompleted:
the maximum workflow order completion date (if any)minduration:
the minimum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)avgduration:
the average total elapsed order processing time for workflow orders in the period (starting from workflow order creation)maxduration:
the maximum total elapsed order processing time for workflow orders in the period (starting from workflow order creation)minprocessing:
the minimum order processing time for workflow orders in the period (starting from when then order was first processed)avgprocessing:
the average order processing time for workflow orders in the period (starting from when then order was first processed)maxprocessing:
the maximum order processing time for workflow orders in the period (starting from when then order was first processed)409 Conflict
: ARGUMENT-ERROR
: missing mindate
This REST URI path provides actions and information about a particular workflow order of a given workflow type
name:
the name of the workflowversion:
the version of the workflowauthor:
the author of the workflowworkflow_instanceid:
the workflow order instance IDworkflowid:
the ID of the workflowworkflowstatus:
the status of the workflow order (see Workflow, Segment, and Step Status Descriptions for possible values)status_sessionid:
the ID of the Qorus application session managing the workflow order data or 0 if noneparent_workflow_instanceid:
the workflow order instance ID of the parent order for this workflow or NULL if nonesubworkflow:
if 1, indicates that the parent_workflow_instanceid
is the parent workflow order in a subworkflow relationshipsynchronous:
if 1, indicates that the order is being executed synchronouslyerrors:
the number of errors raised against the orderbusiness_error:
a boolean flag indicating if the workflow order has an error status due to a business errorworkflowstatus_orig:
if the order status is OMQ::StatBlocked or OMQ::StatCanceled, this value will reflect the original status of the workflow order (see Workflow, Segment, and Step Status Descriptions for possible values)custom_status:
a custom status for the orderscheduled:
the scheduled datepriority:
the priority of the workflow orderstarted:
the date/time the order was createdcompleted:
the date/time order processing completedmodified:
the last modified date/time for the orderoperator_lock:
a string giving the username of the user with an operator lock on the ordernote_count:
the number of notes stored against the orderdeprecated:
a boolean value indicating if the workflow is deprecated or not; deprecated workflows are by default not displayed in the UIautostart:
the integer autostart value for the workflowmanual_autostart:
a boolean flag set if the autostart
value has been changed manually, in which case the manual setting takes precendence over any new definitions loaded with oloadmax_instances:
a value limiting the maximum number of execution instances that can run at onceexternal_order_instanceid:
a unique external key for the orderstaticdata:
a hash of workflow order static datadynamicdata:
a hash of workflow order dynamic data (if any)keys:
a hash of workflow order keys and valueswarning_count:
the number of warnings raised against the ordererror_count:
the number of errors raised against the orderStepInstances:
a list of step hashes giving information about the execution status of workflow steps; each element is a hash with the following keys:workflow_instanceid:
stepid:
the ID of the stepind:
the step array index starting with 0stepname:
the name of the stepstepversion:
the version of the stepsteptype:
type of the stepstepstatus:
the current execution status of the step (see Workflow, Segment, and Step Status Descriptions for possible values)retries:
the number of retries executed on the stepskip:
a boolean value indicating if the step logic was skippedcustom_status:
a custom status for the stepstarted:
the date/time the step was first executedcompleted:
the date/time step processing completedfunction_instanceid:
the function ID of the primary step functionsubworkflow_instanceid:
the workflow order ID of any subworkflow order instance (for bound subworkflow steps only)business_error:
a boolean flag indicating if the step has an error status due to a business errorErrorInstances:
a list of hashes giving information about errors and warnings raised against the order; each element is a hash with the following keys:error_instanceid:
a unique ID for the errorworkflow_instanceid:
the workflow order instance IDstepid:
the stepid where the error was raisedind:
the step array index starting with 0 where the error was raisedseverity:
the severity of the error (see Error Severity Codes for possible values)retry:
1 if the error caused a retryerror:
the string error code for the errordescription:
an optional description of the errorinfo:
an optional string providing additional information about the errorbusiness_error:
a boolean flag indicating if the error is a business errorcreated:
the date/time the error was createdHierarchyInfo:
a hash of workflow order information; the keys are workflow order instance IDs for all workflow orders linked to each other through parent-child relationships in the hierarchy of the current workflow order; the values are order information hashes similar to the top-level of the return value of this APIAuditEvents:
a list of audit information hashesLastModified:
the last modified date/time of the workflow orderactions:
a list of possible actions on the workflownotes:
a list of notes saved against the order; each element is a REST Order Note Hashworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnote:
(required) a string note that gives the reason for breaking the operator lock"OK"
upon successful executionworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnewdata
(*hash<auto>): the new dynamic data for the current workflow order400 Bad Request
: invalid or missing argument403 Forbidden
: access or authorization erroroptions:
(hash) an optional hash of option names and values; if any options are not valid for the workflow, then an exception is raised and the synchronous workflow execution instance is not startedworkflow_instanceid:
the workflow instance ID of the orderstatus:
the status of the workflowdynamicdata:
the dynamic data of the workflow order instance409 Conflict
: SHUTDOWN-IN-PROGRESS
: cannot start new workflows because the system is shutting down403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)orderby:
one or more field names for sorting the outputerror:
the error text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)description:
the description text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be given)info:
the info text to search (can also include '' characters for use with the LIKE operator; in this case only 1 value can be givenstepid:
limit the search to one or more stepidsseverity:
limit the search to one or more severity valuesname:
limit the search to one or more step namesversion:
limit the search to one or more step versionsretry:
limit the search to errors with or without the retry flagbusiness_error:
limit the search to errors with or without the business_error flagerror_instanceid:
mit the search to one or more error_instanceidsmindate:
give the lower date range for the error searchmaxdate:
give the upper date range for the error searchlimit:
the maximum number of errors to returnoffset:
the starting error to return (use when paging for example)name:
the name of the workflowversion:
the version of the workflowworkflow_instanceid:
the workflow instance IDworkflowid:
the workflow IDstepid:
the step ID where the error occurredstepname:
the name of the step where the error occurredstepversion:
the version of the step where the error occurredind:
the array step index number where the error occurredworkflowstatus:
current status of the workflow (see Workflow, Segment, and Step Status Descriptions for possible values)started:
the date and time when the workflow order started processingcompleted:
the date and time when the workflow order was completedparent_workflow_instanceid:
any parent workflow instance IDcustom_status:
the custom status of the workflow order, if anypriority:
the priority of the workflow orderscheduled:
any scheduled date for the workflow ordererror_instanceid:
the error instance IDerror:
the error code stringdescription:
a description for the error (if any)info:
additional information about the error (if any)severity:
an error severity code (see Error Severity Codes for possible values)created:
the date and time the error was raisedretry:
the retry count of the errorbusiness_error:
a boolean flag indicating of the error is a business errorcustom_status_desc:
a descriptive string for the custom status (if any)note:
(required) a string note that gives the reason for setting the operator lock"OK"
upon successful executionlimit:
the maximum number of notes to return; if omitted then all notes are returned403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)note
(string): the note to create on the order403 Forbidden
: access or authorization errordate:
(optional) parsed as a date; this is the new scheduled date to set; if not present, then any scheduled date will be removed"OK"
upon successful execution409 Conflict
: SESSION-ERROR
: cannot reschedule workflow data owned by a foreign session409 Conflict
: WORKFLOW-STATUS-ERROR
: only workflows with status OMQ::StatReady or OMQ::StatScheduled or blocked or canceled workflows with original status OMQ::StatReady or OMQ::StatScheduled can be rescheduled409 Conflict
: RESCHEDULE-ERROR
: reschedule failed because workflow order data started processing while the request was being processed403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)steps_updated:
(deprecated) always 0 in this version of Qorussegments_updated:
the number of segments updatedworkflow_updated:
always True in this version of Qorusworkflow_status:
always OMQ::StatRetry in this version of Qoruscached:
True if the workflow data is currently cached409 Conflict
: STATUS-ERROR
: workflow data does not have either OMQ::StatError, OMQ::StatAsyncWaiting, or OMQ::StatRetry status409 Conflict
: SESSION-ERROR
: cannot change status for workflow data managed by another Qorus instance (foreign session ID)409 Conflict
: RETRY-ERROR
: invalid workflow instance ID403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)steps_updated:
number of steps updatedsegments_updated:
number of segments updatedworkflow_status:
always OMQ::StatErrorold_status:
the old workflow data statusqueued_detached_segments:
number of detached segment events queuedqueued_subworkflows:
number of subworkflow events queuedqueued_async_messages:
number of async events queuedqueued_sync_events:
number of workflow synchronization events queuedqueued_async_retries:
number of async events queuedqueued_retries:
number of retry events queuedqueued_fixed_retries:
number of retry events with a fixed retry time queued403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)priority:
the new order priority from 0 - 999; priority 0 is the highest; 999 is the lowest"OK"
upon successful execution409 Conflict
: SESSION-ERROR
: cannot reschedule workflow data owned by a foreign session409 Conflict
: WORKFLOW-STATUS-ERROR
workflows with status OMQ::StatComplete cannot have their priority changed403 Forbidden
: AUTHORIZATION-ERROR
this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)stepid:
(required) the step ID to skipind:
(optional) one or more step array index values to skip (ranges accepted; ex: "1,3,5-7"
); if not present defaults to 0noretry:
(optional) parsed with Qore::parse_boolean(); if True then no retry will be executed409 Conflict
: SKIP-STEP-ERROR
: step is a subworkflow step; step has not been executed in the given workflow order instance; the given workflow instance ID does not exist409 Conflict
: STEP-STATUS-ERROR
: step status does not allow it to be skipped (ex: IN-PROGRESS, COMPLETE)409 Conflict
: SESSION-ERROR
: workflow order instance belongs to another Qorus session403 Forbidden
: AUTHORIZATION-ERROR
: this exception is thrown when Role Based Access Control is enabled and the user does not have sufficient privileges for the operation403 Forbidden
: WORKFLOW-ACCESS-ERROR
: this is exception is thrown when Role Based Access Control is enabled and the user does not have the right to access the given workflow (for more information, see Interface Groups)noretry
argument is passed as True.newdata
(hash<auto>): the new static data for the current workflow order; must be a non-empty400 Bad Request
: invalid or missing argument403 Forbidden
: access or authorization errorworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestworkflow_status
(string): the status of the order after updating403 Forbidden
: access or authorization error409 Conflict
: exception processing requestnote:
(optional) a string note that gives the reason for removing the operator lock; if not passed, a default note will be added"OK"
upon successful executionorderkeys
(OrderKeySet): the order keys to replace for the current workflow ordertruncate
(*bool): truncate any key values automatically to the length of the column (4000 characters)400 Bad Request
: invalid orderkeys argument403 Forbidden
: access or authorization error