SAsamsara
Beta APIs

[beta] Patches a job

Patches an existing job and returns it.

To use this endpoint, select Write Jobs under the Equipment category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

patch/beta/industrial/jobs

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Query parameters

idstring required

A jobId or uuid in STRING format. JobId must be prefixed with jobId:(Examples: "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596", "jobId:98765").

Request body

keepHistoryboolean

Defaults to true if user does not want to overwrite entire history for an active job (irrelevant for scheduled/completed jobs)

Example request

{
  "job": {
    "address": {
      "address": "1990 Alameda st, San Francisco, Ca 94103",
      "latitude": 37.456345,
      "longitude": 34.5633749,
      "name": "Worksite #1"
    },
    "customerName": "Samsara",
    "endDate": "2019-06-13T19:08:25Z",
    "fleetDeviceIds": [
      1234567,
      654321
    ],
    "id": "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596",
    "industrialAssetIds": [
      "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596",
      "ba84a7e2-9c8d-481f-a248-7cce6b22be9d"
    ],
    "name": "My Job Name",
    "notes": "These are my notes",
    "ontimeWindowAfterArrivalMs": 300000,
    "ontimeWindowBeforeArrivalMs": 300000,
    "startDate": "2019-06-13T19:08:25Z"
  },
  "keepHistory": true
}

Response

OK response.

idstring

The job id of the failed request

uuidstring

The uuid of the failed request

Example response

{
  "data": {
    "address": {
      "address": "1990 Alameda st, San Francisco, Ca 94103",
      "latitude": 37.456345,
      "longitude": 34.5633749,
      "name": "Worksite #1"
    },
    "createdAt": "2019-06-13T19:08:25Z",
    "customerName": "Samsara",
    "endDate": "2019-06-13T19:08:25Z",
    "fleetDevices": [
      {
        "id": 123456,
        "name": "My Device"
      }
    ],
    "id": "1553",
    "industrialAssets": [
      {
        "id": "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596",
        "name": "My asset"
      }
    ],
    "modifiedAt": "2019-06-13T19:08:25Z",
    "name": "My Job Name",
    "notes": "These are my notes",
    "ontimeWindowAfterArrivalMs": 300000,
    "ontimeWindowBeforeArrivalMs": 300000,
    "startDate": "2019-06-13T19:08:25Z",
    "status": "active",
    "uuid": "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596"
  },
  "id": "1553",
  "uuid": "8d218e6c-7a16-4f9f-90f7-cc1d93b9e596"
}

Changes

No recorded changes to this operation across all 1 revision of this API.