Skip to main content
Files can be shared with drivers as part of job, ensuring employees in the field have access to information they need to complete their work successfully. Added using the manager website or via the API. Supported formats:
  • Images: JPG, PNG
  • Spreadsheets: CSV, XLS
  • Text documents: TXT, DOC, RTF
  • Other: PDF

Importing job files

Attaching a file to a job is done using a presigned URL uses the following process:
  1. Add the resource (file name) to a job via the create or update job endpoints e.g. resources”: [{"name" : "MANUAL.pdf"}]. See Create Job and Update Job API details endpoint
  2. For each file to be attached use the getPresignedPost endpoint adding the jobID from the job created/updated and resource name to the body getPresignedPost e.g. {"jobId": "6ghf2714ec6f35ff4df8eb293","resource": "MANUAL.pdf"}. See Adding Files: Obtain a pre-signed URL endpoint
  3. Copy the response from the getPresignedPost and create a new POST call using the URL provided and the other fields as the body. In the file field of the body select your file to be upload. See below on adding Files using a pre-signed URL. Repeat steps for each file to be attached.
Note: The uploaded file will have the format and the name of the file specified when using getPresignedPost (even where there is a difference from the original file).

Adding Files: Using a pre-signed URL

POST request using the response of the presigned post. Note: This explanation uses the example response after obtaining a pre-signed URL to illustrate this endpoint use.
POST using the url returned in getPresignedPost. Example: POST https://mn-mw-bff-job-resources-bucket-live1-euwe1.s3.eu-west-1.amazonaws.com/
HTTP Header: n/a Parameters: n/a Body
KeyValue
Content-Typeapplication/pdf
bucket’mn-mw-bff-job-resources-bucket-live1-euwe1’
X-Amz-Algorithm’AWS4-HMAC-SHA256’
X-Amz-Credential’ASIATRJUZHSHVMUPZJP6/20240807/eu-west-1/s3/aws4_request’
X-Amz-Date’20240807T131901Z’
X-Amz-Security-Token’QoJb3JpZ2luX2VjEB0aCWV1LXdlc3QtMSJHMEUCIGDsOvnffgfgcvfxcvdx/YaqCxdUdYtvi8TaIR8bQJNUUE8Q1RQ9XXJHkJHbAuIqsQMIFhAFGgwyNDMzMTMyMjg5NDMiDEehW820VdxJEnZF1yqOA8C4zzsLzyaMHvbrf4tWxUM587dKK0XGcZQ==‘
key’jobs/66b2714ec6f35134df8eb293/PDF - MANUAL.pdf’
policy’eyJleHBpcmF0aW9uIjoiMjAyNC0wOC0wN1QxMzo1Nzo0M1oiLCJjb25kaXRpb25zIjpbWyJlcSIsIiRDb250ZW50LFtei1BbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJYLUFtei1DcmVkZW50aWFsIjoiQVNJQVRSSlV1xTDA2Q2xic1VhK2ZtME85==‘
X-Amz-Signature’969111393ea47e9d117f002c7bf52c88dc9dccfa087c5b2c43dbd687’