---
title: "Create Request"
method: POST
path: "/api/v1/data-subjects/requests"
tags: ["Data Subjects"]
---

# Create Request

`POST /api/v1/data-subjects/requests`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `api/v1/login`
  - API key in query parameter `x-api-key`
  - API key in header `x-api-key`

Record a request for an admin to review. Returns the open request when one already exists.

## Request body

- DataSubjectRef: Identify a subject: a builder by ``user_id`` or ``username`` (the email under SSO), an end user by id.
  - `end_user_id` string, nullable
  - `flow_ids` string[], nullable
  - `subject_type` 'builder' | 'end_user', required
  - `user_id` string, uuid, nullable
  - `username` string, nullable

## Response `200`

Successful Response

- DataSubjectRequestRead
  - `counts` object, nullable, required
  - `decided_at` string, date-time, nullable, required
  - `decided_by` string, uuid, nullable, required
  - `due_at` string, date-time, required
  - `error` object, nullable, required
  - `finished_at` string, date-time, nullable, required
  - `id` string, uuid, required
  - `overdue` boolean
  - `phase` string, nullable, required
  - `refusal_note` string, nullable, required
  - `requested_at` string, date-time, nullable, required
  - `requested_by` string, uuid, nullable, required
  - `source` string, required
  - `status` string, required
  - `subject_label` string, nullable, required
  - `subject_type` string, required
  - `subject_user_id` string, uuid, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `4349fbe90c64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/data-subjects/requests/post.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) - [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/4349fbe90c64?raw)