---
title: "Trigger a platform background job"
method: POST
path: "/api/v1/device/jobs/{identifier}/run"
tags: ["device"]
---

# Trigger a platform background job

`POST /api/v1/device/jobs/{identifier}/run`

Attempts to trigger the named platform background job. iOS and Mac Catalyst submit a BGTaskRequest for the identifier; pass `type` when the task is known to be an app refresh task. Android currently reports `success=false` because WorkManager worker types and request inputs cannot be reconstructed safely from the listed identifier or tags.

## Path parameters

- `identifier` string, required

## Request body

- JobRunRequest — unresolved $ref

## Response `200`

Job trigger result.

- JobRunResponse — unresolved $ref

## Other responses

- `500` — Internal server error.
- `501` — Capability not implemented by the connected backend.

## Changes

- **2026-08-17** `dcf9b09e550f` — 1 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `501`
  - added the required property `capability` to the response with the `501` status
  - added the required property `error` to the response with the `501` status
  - added the required property `reason` to the response with the `501` status
- **2026-04-27** `9bde894e7b87` — 1 info
  - endpoint added
- **2026-04-27** `a0d9fe851d57` — 1 breaking
  - api path removed without deprecation
- **2026-04-27** `58424f69ec54` — 1 info
  - endpoint added
- **2026-04-14** `182d5c8c4462` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/changes/api/v1/device/jobs/:identifier/run/post.md)

---

[API](https://skmtc.dev/dotnet/apis/devflow-agent-protocol.md) · [All operations](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotnet/devflow-agent-protocol/revisions/31dec8eed3de/schema)