---
title: "Create and stream a PII expansion job"
method: POST
path: "/v1/pii-expansion/stream"
tags: ["pii-expansion"]
---

# Create and stream a PII expansion job

`POST /v1/pii-expansion/stream`

Create a persisted PII-expansion job and immediately stream typed server-sent events until completion. Use the `X-Job-Id` response header to reconnect at `GET /v1/pii-expansion/jobs/{job_id}/stream` with `Last-Event-ID`.

## Request body

- PiiExpansionRequest — Supported request payload for v1 PII expansion.
  - `depth` 'standard' | 'deep'
  - `maxCandidates` integer
  - `seeds` PiiExpansionSeeds — Supported seed types for v1 identity expansion.
    - `emails` string[]
    - `phones` string[]
    - `usernames` string[]
  - `subject` PiiExpansionSubject, required — Subject details supported by v1 PII expansion.
    - `aliases` string[]
    - `name` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/intraceai/apis/intelligence-api.md) · [All operations](https://skmtc.net/intraceai/apis/intelligence-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intraceai/intelligence-api/revisions/c0216eef7380/schema)