v1.0

put

/ec-rule-svc/rest/v1.0/studies/{studyId}/{mode}/cancelRuleJob

Cancels job associated with a given rule ID, if the job is in pending or running state.

Request

Path Parameters
  • Study mode identifies the study data segment. Allowed values: design (draft workspace), test (UAT sandbox), training (practice environment), production (live subject data).
    Example:
    test
  • Unique identifier of the study. Uses UUID in a 32-character uppercase hexadecimal string format.
    Example:
    C360089F838D4DD980322DE22545C49F
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
List of rule identifiers supplied to the re-execution APIs.
Show Source
Nested Schema : ruleIds
Type: array
Ordered collection of rule identifiers to include. Provide between one and five hundred values.
Show Source
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Rule UUID. Accepts either a compact 32-character hexadecimal value or a hyphenated 36-character UUID.
    Example: E4C2D1B7A8F9465FB1E2A3C4D5879E10
Example:
[
    "0E1A63683F884B13A3E7BEE9CA4FF1EA",
    "DBF2C278385E4AF4BA4FBF2AA76D194F"
]
Examples

Back to Top

Response

Supported Media Types

200 Response

Rule execution was successful.
Body ()
Root Schema : JobStatusResponse
Type: object
Response payload returned by rule job status endpoints.
Show Source
  • Minimum Length: 1
    Maximum Length: 512
    Overall outcome for the job status request. Provide "Success" when all jobs were evaluated successfully; otherwise supply a concise explanation of the failure.
    Example: Success
  • jobStatus
    Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Nested Schema : jobStatus
Type: array
Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Show Source
Example:
[
    {
        "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
        "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
        "jobStatus":"Success",
        "ruleName":"onesection - create query with form submit dates",
        "jobStartDate":"2025-09-07 19:12:08.747",
        "groupJobId":"F8491962C1574F0A89195560670B59E8"
    }
]
Nested Schema : JobStatusEntry
Type: object
Single rule execution job status entry.
Show Source
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the batch job that orchestrated this individual execution. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 589F499D700340DE866C8EF3ACCE1547
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule execution job. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 91F4E249F44C4C14A372EE30CEA6B7A8
  • Minimum Length: 23
    Maximum Length: 23
    Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}$
    Job start timestamp formatted as yyyy-MM-dd HH:mm:ss.SSS in the service timezone.
    Example: 2025-09-07 19:12:08.747
  • Minimum Length: 4
    Maximum Length: 64
    Allowed Values: [ "Running", "Success", "Failed", "Cancelled", "Completed with errors", "Pending", "Rule is not in publish state", "Rule is invalid", "Rule is disabled", "Rule doesn't exist", "Failed to cancel job", "Skipped because subject is locked" ]
    Execution outcome for an individual rule job. Allowed values: Running (job currently executing), Success (job completed without errors), Failed (job exited because of an error), Cancelled (job was cancelled before completion), Completed with errors (job finished but produced warnings), Pending (job waiting to start), Rule is not in publish state (rule not promoted to the target mode), Rule is invalid (rule failed validation), Rule is disabled (rule disabled for the selected mode), Rule doesn't exist (referenced rule is missing), Failed to cancel job (service could not cancel the job), Skipped because subject is locked (subject lock prevented execution).
    Example: Success
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: E4C2D1B7A8F9465FB1E2A3C4D5879E10
  • Minimum Length: 1
    Maximum Length: 256
    Rule display name associated with the job execution.
    Example: onesection - create query with form submit dates
Example:
{
    "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
    "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
    "jobStatus":"Success",
    "ruleName":"onesection - create query with form submit dates",
    "jobStartDate":"2025-09-07 19:12:08.747",
    "groupJobId":"F8491962C1574F0A89195560670B59E8"
}
Examples

400 Response

Returned when the request payload fails validation, such as when ruleIds is empty, contains malformed UUIDs, or required fields are missing.
Body ()
Root Schema : JobStatusResponse
Type: object
Response payload returned by rule job status endpoints.
Show Source
  • Minimum Length: 1
    Maximum Length: 512
    Overall outcome for the job status request. Provide "Success" when all jobs were evaluated successfully; otherwise supply a concise explanation of the failure.
    Example: Success
  • jobStatus
    Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Nested Schema : jobStatus
Type: array
Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Show Source
Example:
[
    {
        "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
        "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
        "jobStatus":"Success",
        "ruleName":"onesection - create query with form submit dates",
        "jobStartDate":"2025-09-07 19:12:08.747",
        "groupJobId":"F8491962C1574F0A89195560670B59E8"
    }
]
Nested Schema : JobStatusEntry
Type: object
Single rule execution job status entry.
Show Source
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the batch job that orchestrated this individual execution. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 589F499D700340DE866C8EF3ACCE1547
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule execution job. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 91F4E249F44C4C14A372EE30CEA6B7A8
  • Minimum Length: 23
    Maximum Length: 23
    Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}$
    Job start timestamp formatted as yyyy-MM-dd HH:mm:ss.SSS in the service timezone.
    Example: 2025-09-07 19:12:08.747
  • Minimum Length: 4
    Maximum Length: 64
    Allowed Values: [ "Running", "Success", "Failed", "Cancelled", "Completed with errors", "Pending", "Rule is not in publish state", "Rule is invalid", "Rule is disabled", "Rule doesn't exist", "Failed to cancel job", "Skipped because subject is locked" ]
    Execution outcome for an individual rule job. Allowed values: Running (job currently executing), Success (job completed without errors), Failed (job exited because of an error), Cancelled (job was cancelled before completion), Completed with errors (job finished but produced warnings), Pending (job waiting to start), Rule is not in publish state (rule not promoted to the target mode), Rule is invalid (rule failed validation), Rule is disabled (rule disabled for the selected mode), Rule doesn't exist (referenced rule is missing), Failed to cancel job (service could not cancel the job), Skipped because subject is locked (subject lock prevented execution).
    Example: Success
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: E4C2D1B7A8F9465FB1E2A3C4D5879E10
  • Minimum Length: 1
    Maximum Length: 256
    Rule display name associated with the job execution.
    Example: onesection - create query with form submit dates
Example:
{
    "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
    "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
    "jobStatus":"Success",
    "ruleName":"onesection - create query with form submit dates",
    "jobStartDate":"2025-09-07 19:12:08.747",
    "groupJobId":"F8491962C1574F0A89195560670B59E8"
}
Examples

500 Response

Returned when cancelRuleJob fails due to an unexpected server-side processing error.
Body ()
Root Schema : JobStatusResponse
Type: object
Response payload returned by rule job status endpoints.
Show Source
  • Minimum Length: 1
    Maximum Length: 512
    Overall outcome for the job status request. Provide "Success" when all jobs were evaluated successfully; otherwise supply a concise explanation of the failure.
    Example: Success
  • jobStatus
    Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Nested Schema : jobStatus
Type: array
Array of job status entries returned by the rule execution service. Allowed job status values: Running, Success, Failed, Cancelled, Completed with errors, Pending, Rule is not in publish state, Rule is invalid, Rule is disabled, Rule doesn't exist, Failed to cancel job, Skipped because subject is locked.
Show Source
Example:
[
    {
        "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
        "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
        "jobStatus":"Success",
        "ruleName":"onesection - create query with form submit dates",
        "jobStartDate":"2025-09-07 19:12:08.747",
        "groupJobId":"F8491962C1574F0A89195560670B59E8"
    }
]
Nested Schema : JobStatusEntry
Type: object
Single rule execution job status entry.
Show Source
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the batch job that orchestrated this individual execution. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 589F499D700340DE866C8EF3ACCE1547
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule execution job. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: 91F4E249F44C4C14A372EE30CEA6B7A8
  • Minimum Length: 23
    Maximum Length: 23
    Pattern: ^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d{3}$
    Job start timestamp formatted as yyyy-MM-dd HH:mm:ss.SSS in the service timezone.
    Example: 2025-09-07 19:12:08.747
  • Minimum Length: 4
    Maximum Length: 64
    Allowed Values: [ "Running", "Success", "Failed", "Cancelled", "Completed with errors", "Pending", "Rule is not in publish state", "Rule is invalid", "Rule is disabled", "Rule doesn't exist", "Failed to cancel job", "Skipped because subject is locked" ]
    Execution outcome for an individual rule job. Allowed values: Running (job currently executing), Success (job completed without errors), Failed (job exited because of an error), Cancelled (job was cancelled before completion), Completed with errors (job finished but produced warnings), Pending (job waiting to start), Rule is not in publish state (rule not promoted to the target mode), Rule is invalid (rule failed validation), Rule is disabled (rule disabled for the selected mode), Rule doesn't exist (referenced rule is missing), Failed to cancel job (service could not cancel the job), Skipped because subject is locked (subject lock prevented execution).
    Example: Success
  • Minimum Length: 32
    Maximum Length: 36
    Pattern: ^[0-9A-Fa-f]{32}$|^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$
    Identifier for the rule. Accepts either a compact 32-character hexadecimal UUID or a hyphenated 36-character UUID.
    Example: E4C2D1B7A8F9465FB1E2A3C4D5879E10
  • Minimum Length: 1
    Maximum Length: 256
    Rule display name associated with the job execution.
    Example: onesection - create query with form submit dates
Example:
{
    "ruleId":"DBF2C278385E4AF4BA4FBF2AA76D194F",
    "jobId":"91F4E249F44C4C14A372EE30CEA6B7A8",
    "jobStatus":"Success",
    "ruleName":"onesection - create query with form submit dates",
    "jobStartDate":"2025-09-07 19:12:08.747",
    "groupJobId":"F8491962C1574F0A89195560670B59E8"
}
Examples

Back to Top