---
title: "Assign a monitoring workflow to a specific user"
method: POST
path: "/monitoring-workflows/{id}/assignment"
tags: ["MonitoringWorkflow"]
---

# Assign a monitoring workflow to a specific user

`POST /monitoring-workflows/{id}/assignment`

Assigns the monitoring workflow identified by `id` to the user given in `assignTo`. Use this endpoint for single-workflow assignment; use `POST /monitoring-workflows/assignments` for bulk assignment. The workflow must not currently be in `REVIEWED_BY_CERTIFYOS` status — if it is, this endpoint returns HTTP 400 with `{"error": "..."}` rather than the assignment result. Requires `MONITORING_WORKFLOW_ASSIGN` or `MONITORING_WORKFLOW_ASSIGN_SELF`. The `tenant-id` header is mandatory.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string, required

## Request body

- CreateMonitoringWorkflowAssignmentRequest — Request to create a new assignment for a monitoring workflow
  - `assignTo` string, required — User ID being assigned to

## Response `200`

Assignment created: `{workflowId, assignment: {assignedTo, assignedBy, assignedAt}, error: null}`.

- AssignmentResult2 — Result of an individual assignment operation
  - `workflowId` string — ID of the credentialing workflow
  - `assignment` AssignmentEntry2
    - `assignedTo` string — User ID the assignment changed to
    - `assignedBy` string — User ID who made the assignment change
    - `assignedAt` string — Timestamp when the assignment was changed
  - `error` string — Error message if assignment failed

## Other responses

- `400` — Invalid request data, or the workflow is in REVIEWED_BY_CERTIFYOS status and cannot be reassigned; response body is `{"error": "..."}`
- `401` — Unauthorized - Authentication required
- `403` — Forbidden - User does not have required permissions
- `404` — Monitoring workflow not found
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)