---
title: "POST /userrequests"
method: POST
path: "/userrequests"
tags: ["UserRequests"]
---

# POST /userrequests

`POST /userrequests`

Submit a user request for requestor, a user  request describes user ask to do operation(s) on Purview. If any workflow's trigger matches with an operation in request, a run of the workflow is created.

## Query parameters

- `api-version` string, required

## Request body

- UserRequestPayload
  - `operations` Operation[], required — The list of operations user want to submit, each operation matches one Purview API call and will do the operation directly.
    - `type` 'CreateTerm' | 'UpdateTerm' | 'DeleteTerm' | 'ImportTerms' | 'UpdateAsset' | 'GrantDataAccess', required — The operation type.
    - `payload` object, required — The payload of each operation which user want to submit.
  - `comment` string — The comment when submit a user request.

## Response `200`

OK

- UserRequestResponse — Describes user ask to do operation(s) on Purview.
  - `requestId` string, uuid, required — The user request id.
  - `requestor` string, uuid, required — The person who submitted the user request.
  - `operations` object[], required — The list of operations user want to submit, each operation matches one Purview API call and will do the operation directly.
    - `type` 'CreateTerm' | 'UpdateTerm' | 'DeleteTerm' | 'ImportTerms' | 'UpdateAsset' | 'GrantDataAccess', required — The operation type.
    - `payload` object, required — The payload of each operation which user want to submit.
    - `workflowRunIds` WorkflowRunId[]
  - `comment` string — The comment when submit a user request.
  - `status` 'NotStarted' | 'InProgress' | 'Failed' | 'Completed' | 'Canceling' | 'CancellationFailed' | 'Canceled', required — The status.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (2022-05-01-preview) `60435bfd503d` — 1 info
  - api operation id `SubmitUserRequests` removed and replaced with `UserRequests_Submit`

[Change history](https://skmtc.dev/azure/apis/purview-workflow/changes/userrequests/post.md)

---

[API](https://skmtc.dev/azure/apis/purview-workflow.md) · [All operations](https://skmtc.dev/azure/apis/purview-workflow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/purview-workflow/revisions/60435bfd503d/schema)