DIdistru
Task

Get a task

Changed on

Fetches a single task by its ID, scoped to the authenticated company. Returns 404 if no task with that ID exists in your company, and 403 if the authenticated user can't access it under their team restrictions. The linked entity is returned as in GET /public/v1/tasks, so it is null when the authenticated user can't view it.

Required permission: tasks_permissions_view.

get/public/v1/tasks/{id}

Request

  • Base URL
    https://app.distru.com
  • Auth
    HTTP bearer

Path parameters

idstring required

ID of the task to fetch, as returned by the list and upsert endpoints. An ID that doesn't exist for your company returns 404.

Response

A single task

Example response

{
  "data": {
    "location": {
      "address": "1234 Warehouse Street, Oakland, CA",
      "company_id": "02c88a3f-d759-4973-88f9-60049d682524",
      "id": "02c88a3f-d759-4973-88f9-60049d682524",
      "license_id": "02c88a3f-d759-4973-88f9-60049d682524",
      "name": "Warehouse 1"
    }
  }
}

Changes

  • e8b3a3d07ad5Revision changes
    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status