> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# admin_alter_jobs

<div className="kinetica-pydoc">
  <div className="dl py method">
    <div className="dt sig sig-object py" id="gpudb.GPUdb.admin_alter_jobs"> <span className="sig-name descname"><span className="pre">admin\_alter\_jobs</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">job\_ids</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">None</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">action</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">None</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">options</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">{"{"}{"}"}</span></span></span><span className="sig-paren">)</span><a href="https://github.com/kineticadb/kinetica-api-python/blob/master/gpudb/gpudb.py#L14566"><span className="viewcode-link"><span className="pre">\[source]</span></span></a></div>

    <div className="dd">
      <p>Perform the requested action on a list of one or more job(s). Based on the type of job and the current state of execution, the action may not be successfully executed. The final result of the attempted actions for each specified job is returned in the status array of the response. See <a className="reference external" href="/content/admin/job_manager/">Job Manager</a> for more information.</p>
      <p><strong>Parameters</strong></p>

      <div className="blockquote">
        <div>
          <div className="dl">
            <div className="dt">job\_ids (<span className="em">list of longs</span>) –</div>

            <div className="dd">
              <p>Jobs to be modified. The user can provide a single element (which will be automatically promoted to a list internally) or a list.</p>
            </div>

            <div className="dt">action (<span className="em">str</span>) –</div>

            <div className="dd">
              <p>Action to be performed on the jobs specified by job\_ids. Allowed values are:</p>

              <ul className="simple">
                <li>
                  <p>cancel</p>
                </li>
              </ul>
            </div>

            <div className="dt">options (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Optional parameters. Allowed keys are:</p>

              <ul className="simple">
                <li>
                  <p><strong>job\_tag</strong> – Job tag returned in call to create the job.</p>
                </li>
              </ul>

              <p>The default value is an empty dict ( {"{"}{"}"} ).</p>
            </div>
          </div>
        </div>
      </div>

      <p><strong>Returns</strong></p>

      <div className="blockquote">
        <div>
          <p>A dict with the following entries–</p>

          <div className="dl simple">
            <div className="dt">job\_ids (<span className="em">list of longs</span>) –</div>

            <div className="dd">
              <p>Jobs on which the action was performed.</p>
            </div>

            <div className="dt">action (<span className="em">str</span>) –</div>

            <div className="dd">
              <p>Action requested on the jobs.</p>
            </div>

            <div className="dt">status (<span className="em">list of str</span>) –</div>

            <div className="dd">
              <p>Status of the requested action for each job.</p>
            </div>

            <div className="dt">info (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Additional information.</p>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>