ScriptX logotype
  • Getting started
  • Documentation
  • Samples
  • Pricing
Free Trial Downloads
  • Home
  • Getting started
  • Documentation
  • Samples
  • Pricing
Developers ›  Knowledge Bank ›  Technical Reference ›  ScriptX.Services ›  Web ServiceAPI Reference ›  PrintHtml ›  cancelJob (PUT)

cancelJob (PUT)

{server}/api/v1/printHtml/canceljob/{jobToken}

Description

Request to cancel (remove) a job as identified by the job token returned (as data.jobIdentifier) from a preceding /PrintHtml/print POST.

If the job is currently pre-processing for printing, it will be asked to stop. Once a job starts printing pages, it cannot be stopped. Jobs in the queue will be removed. Once cancelled the job status will be "Abandoned".

ScriptX.Services for Windows PC 2.10 or ScriptX Server 10.3 or later is required.

Applies to:

  • ScriptX.Services for On-Premise Devices (Authorisation header is ignored)
  • ScriptX.Services for Windows PC

Request parameters


    jobToken (string, required)
jobToken (string, required)
The job identifier for the job being cancelled, as returned by a preceding POST to /PrintHtml/print.

Response model


JobStatus {
    message (string, optional),
    status (integer, optional): 0 = NotStarted, 1 = Queued, 2 = Starting, 3 = Downloading, 
                                4 = Downloaded, 5 = Printing, 6 = Completed, 7 = Paused, 
                                8 = PrintingPdf, 100 = Collected, 101 = CodeException, 
                                102 = CompletedWaitingForCollection, -2 = Abandoned, -1 = ItemError,
    jobIdentifier (string, optional)
}  

JobStatus:
message (string, optional)
String that may contain additional information regarding the current status of the job e.g. error description.
status (integer, optional)
Integer that indicates the current status of the job identified in the API request jobToken parameter.
0
Not Started - the job has not yet reached the ScriptX Server print queue.
1
Queued - the job is waiting in the ScriptX Server print queue.
2
Starting - the job is being analysed.
3
Downloading - the content to be printed is downloading.
4
Downloaded - the content has completed downloading and is ready to print.
5
Printing - The HTML engine is printing the content.
6
Completed - the content has been spooled to a physical printer and has completed processing by ScriptX Server and ScriptX.Services.
7
Paused - the print queue is paused (this is not supported and will not occur).
8
Printing- The PDF engine is printing the content.
100
Collected - the output from printing to file has been collected and has completed processing by ScriptX Server and ScriptX.Services.
101
CodeException - an exception occurred in the code. Please report full details to MeadCo.
102
CompletedWaitingForCollection - the content has been printed to a file and is now awaiting collection by a call to the download endpoint. This is an internal status value that is not returned. The value 6 (Completed) will be returned. Note that the print endpoint will have returned a status stating whether the output is to a file or device.
-1
ItemError - an error occured while processing the job.
-2
Abandoned - the job was cancelled, was abandoned due to appearing to be stuck or had file output that has not been collected.
jobIdentifier (string, optional)
Returns the job token as confirmation of the request this is answering.
  • Knowledge Bank
  • 'How To' Guides
    • ScriptX.Services
      • Introduction
      • Getting started
      • Evaluate with modern code
      • Maintaining investment in current code
        • Stage 1: Adding UI
        • Stage 2: Printing with ScriptX.Services
        • Stage 3: Summary and review
        • Stage 4: Error reporting
        • Stage 5: Prompted printing
        • Stage 6: Preparing for advanced uses
        • Stage 7: WaitForSpoolingComplete
        • Stage 8: Recommendations for some common issues
      • Printing with the API
      • MeadCoScriptXJS Library
      • Installing ScriptX.Services
        • For Windows PC
        • For On Premise Devices hosted on Windows Server
        • For On Premise Devices hosted on Windows 10/11
        • Configure options For On Premise Devices
        • Cloud
      • Orchestrator
      • Debugging
      • License deployment
        • For Windows PC
        • For On Premise Devices
      • Samples
        • Configure for Windows PC
        • Configure for On Premise
        • Configure for Cloud
    • Security Manager
      • Deploying a license or revision
    • ScriptX.Add-on
      • Introduction
      • Installing ScriptX on client PCs
      • Basic printing with ScriptX
      • Advanced printing features
      • Backwards compatibility
      • How to check if ScriptX is installed
      • License deployment
      • Quick start with Visual Studio
        • ASP.NET MVC
        • ASP.NET Web Forms
      • Nuget Packages
        • MeadCoScriptXJS Library
        • Installer helpers
        • ASP.NET WebForms Controls
        • Helpers for ASP.NET MVC
      • Client-side printing samples
  • Technical Reference
    • ScriptX.Services
      • Web service API
        • Service Description
          • (GET)
        • Licensing
          • licensing (GET)
          • licensing (POST)
          • licensing/ping (GET)
        • Printer
          • settings (GET)
          • current (GET)
          • current (PUT)
          • connection (PUT)
          • connection (DELETE)
        • PrintHtml
          • settings (GET)
          • deviceinfo (GET)
          • htmlPrintDefaults (GET)
          • print (POST)
          • status (GET)
          • download (GET)
          • canceljob (PUT)
        • PrintPdf
          • print (POST)
          • status (GET)
          • download (GET)
        • PrintDirect
          • print (POST)
      • Orchestrator API
        • v1
          • GET
        • v2
          • PUT
          • GET
      • ScriptX.Services compatibility roadmap
    • Security Manager
      • How it works
      • License Expiry
      • Testing for a valid license
      • About the license file (.mlf)
        • LICENSE
        • APPLICENSE
        • TITLE
        • DOMAINS
        • DOMAIN
        • PERMISSION
      • API
        • Apply
        • License
        • result
        • validLicense
    • ScriptX.Add-on
      • factory
        • baseUrl
        • ComponentVersionString
        • IsUniqueIDAvailable
        • OnDocumentComplete
        • relativeUrl
        • ResetUniqueID
        • ScriptXVersion
        • SecurityManagerVersion
        • Shutdown
        • UniqueID
      • printing
        • AddPrinterConnection
        • BatchPrintPDF
        • BatchPrintPDFEx
        • bottomMargin
        • collate
        • copies
        • currentPrinter
        • DefaultPrinter
        • disableUI
        • duplex
        • duplex2
        • EnumJobs
        • EnumPrinters
        • footer
        • GetJobsCount
        • GetMarginMeasure
        • header
        • headerFooterFont
        • IsSpooling
        • IsTemplateSupported
        • leftMargin
        • onafterprint
        • onbeforeprint
        • onbeforeunload
        • onpagesetup
        • onuserpagesetup
        • onuserprint
        • onuserprintpreview
        • orientation
        • OwnQueue
        • pageHeight
        • PageSetup
        • pageWidth
        • paperSize
        • paperSource
        • paperSource2
        • portrait
        • Preview
        • Print
        • printBackground
        • printer
        • PrintHTML
        • PrintHTMLEx
        • PrintPDF
        • PrintSetup
        • printToFileName
        • RemovePrinterConnection
        • rightMargin
        • SetMarginMeasure
        • SetPageRange
        • SetPreviewZoom
        • SetPrintScale
        • Sleep
        • templateURL
        • topMargin
        • TotalPrintPages
        • unprintableBottom
        • unprintableLeft
        • unprintableRight
        • unprintableTop
        • WaitForSpoolingComplete
      • printerControl
        • attributes
        • Bins
        • Forms
        • isLocal
        • isNetwork
        • isShared
        • Jobs
        • location
        • name
        • Pause
        • port
        • Purge
        • Resume
        • serverName
        • shareName
        • status
      • Job
        • Delete
        • Pause
        • Restart
        • Resume
      • enhancedFormatting
        • allFooterHeight
        • allHeaderHeight
        • allPagesFooter
        • allPagesHeader
        • extraFirstFooterHeight
        • extraFirstPageFooter
        • firstFooterHeight
        • firstHeaderHeight
        • firstPageFooter
        • firstPageHeader
        • pageRange
        • printingPass
      • rawPrinting
        • printer
        • printDocument
        • printString
    • Change and history logs
    • Articles
      • v1.15.x ScriptX Client Library
      • Dialogs with ScriptX.Services
      • Accessing protected content
      • Long term servicing (LTS)
 
ScriptX logotype
Home Getting started Documentation Samples Contact us

© 2025 Mead & Co Limited.

Follow us:
LinkedIn   GitHub
X

Warning:

This ScriptX.Add-on sample can only be viewed using Internet Explorer.