---
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

> 16 revisions in range; 14 could not be searched.

- **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)