Create Session From Extraction

curl --request POST \
  --url https://api.example.com/api/v1/user-extractions/{extraction_id}/create-session \
  --header 'Authorization: Bearer <token>'

{
  "session_id": "<string>",
  "dataset_id": "<string>",
  "leads_count": 123,
  "status": "<string>"
}

user-extractions

Create Session From Extraction

Create an enrichment session from a saved extraction.

This endpoint converts an extraction (stored as JSON in Supabase storage) into a new enrichment session with associated dataset and dataset_rows.

Flow:

Fetch user_extractions record (validate ownership)
Download JSON from extraction-files bucket using storage_path
Parse JSON array of lead objects
Create processing_sessions record (pipeline_type=“enrichment”)
Create datasets record (source_type=“extraction”)
Create dataset_rows records (one per lead)
Update user_extractions.session_id to link them
Return session details

Args: extraction_id: The ID of the extraction to convert current_user: Authenticated user information cache: Redis cache instance settings: Application settings

Returns: CreateSessionResponse with session_id and metadata

Raises: HTTPException: If extraction not found, access denied, or processing fails

POST

api

user-extractions

{extraction_id}

create-session

Create Session From Extraction

curl --request POST \
  --url https://api.example.com/api/v1/user-extractions/{extraction_id}/create-session \
  --header 'Authorization: Bearer <token>'

{
  "session_id": "<string>",
  "dataset_id": "<string>",
  "leads_count": 123,
  "status": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

extraction_id

string

required

Response

Successful Response

Response model for creating a session from an extraction.

session_id

string

required

Created session ID

dataset_id

string

required

Created dataset ID

leads_count

integer

required

Number of leads loaded

status

string

required

Session status

Delete Extraction

Bulk Delete Extractions