---
title: "Find Subject"
method: POST
path: "/api/v1/data-subjects/find"
tags: ["Data Subjects"]
---

# Find Subject

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

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

Count what Langflow holds about a subject, without creating a request.

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

- DryRunSummary
  - `blocked_by` 'deployed_flows' | 'last_administrator', nullable
  - `counts` object, required
  - `deployments` string[]
  - `shared_flows` string[]
  - `subject_type` string, 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/find/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)