Skip to main content
PATCH
/
2025-09
/
tasks
/
{task_id}
curl --request PATCH \
  --url https://public-api.stora.co/2025-09/tasks/{task_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Updated Task Title",
  "description": "Updated description for the task.",
  "due_at": "2025-02-25T14:41:00Z",
  "assignee": {
    "id": "staff_06778802edebb94d"
  },
  "site": {
    "id": "site_14b419f1096013f1"
  },
  "resource": {
    "id": "unit_1e36123098e22cf8"
  },
  "metadata": {
    "source": "api",
    "external_id": "ext_456"
  }
}
'
{
  "task": {
    "id": "task_195h6kfm9ro15lof",
    "assignee": {
      "id": "staff_06778802edebb94d"
    },
    "completed_at": null,
    "created_at": "2025-02-22T14:41:00Z",
    "creator": {
      "id": "staff_06778802edebb94d"
    },
    "description": "Updated description for the task.",
    "due_at": "2025-02-25T14:41:00Z",
    "metadata": {
      "source": "api",
      "external_id": "ext_456"
    },
    "resource": {
      "id": "unit_1e36123098e22cf8"
    },
    "site": {
      "id": "site_14b419f1096013f1"
    },
    "status": "open",
    "title": "Updated Task Title",
    "updated_at": "2025-02-22T14:41:00Z"
  },
  "meta": {
    "request_id": "01563646-58c1-4607-8fe0-cae3e92c4477",
    "curies": [
      {
        "name": "bo",
        "href": "https://app.stora.test{rel}",
        "templated": true,
        "title": "Backoffice"
      },
      {
        "name": "sf",
        "href": "https://acme.stora.test{rel}",
        "templated": true,
        "title": "Storefront"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer Token necessary to use API

Path Parameters

task_id
string
required

The ID of the task to retrieve

Body

application/json

Update Task Request

title
string

The title of the task

description
string | null

Optional description for the task, to remove existing description set to null

due_at
string<date-time> | null

The due date and time for the task, to remove existing due date set to null

site
object | null

To remove the association, set site to null

assignee
object | null
metadata
object | null

Set of key-value pairs for storing additional information on the task. Learn more about metadata.

resource
object

Response

Task updated

Single Task

task
object

Task

meta
object