Skip to content
/
Create a seed list from u...

Create a seed list from uploaded file.

Request

Creates a seed list from a previously uploaded file. The uploaded file must meet the following requirements:

  • Format: Plain text, UTF-8 encoded. Binary files (ZIP, JAR, ELF, PDF, etc.) are rejected.
  • Structure: One value per line. Each line is treated as a single seed list entry.
  • No header row: The file must not include a header row. Every line in the file is used as a seed value.
  • Non-empty: The file must contain at least one line.
Security
ApiKeyAuth
Bodyapplication/jsonrequired

The values to create a seed list file.

seed_file_namestring

The name you wish to assign to the seed list file. Optional -- defaults to the uploaded file's own file name (from file_upload_id) when omitted or blank.

Example:"seedlist.csv"
descriptionstring, <= 1000 characters

An optional description for the seed list file.

Example:"This is a seed list of first names."
localestring

The locale of the seed list file.

Example:"en_US"
industry_idstring

The ID of the industry associated with this seed list file.

Example:"a9ec779e-fc41-d440-866e-d0144049ebd4"
file_upload_idstringrequired

The ID of the uploaded file to be used as the seed list. The file must be plain text (UTF-8), with one seed value per line and no header row. Binary files are not supported.

Example:"file-123"
tagsArray of objects(Tag)

Tags associated with the seed list file.

Example:
[
  {
    "key": "key1",
    "value": "value1"
  }
]
curl -i -X POST \
  https://help-api.delphix.com/_mock/data-control-tower/continuous-data/2026.5.0.0/continuous-data-apis-dct-2026.5.0.0/synthetic/seed-lists \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "seed_file_name": "seedlist.csv",
    "description": "This is a seed list of first names.",
    "locale": "en_US",
    "industry_id": "a9ec779e-fc41-d440-866e-d0144049ebd4",
    "file_upload_id": "file-123",
    "tags": [
      {
        "key": "key1",
        "value": "value1"
      }
    ]
  }'

Responses

Seed list file creation initiated.

Bodyapplication/json
jobobject(Job)

An asynchronous task.

Response
{
  "job": {
    "id": "job-123",
    "status": "RUNNING",
    "is_waiting_for_telemetry": true,
    "type": "DB_REFRESH",
    "localized_type": "DB Refresh",
    "error_details": "Unable to connect to the engine.",
    "warning_message": "Failed to remove local MaskingJob, engineId: 3 localMaskingJobId: 7.",
    "target_id": "vdb-123",
    "target_name": "vdb",
    "work_source_id": "string",
    "work_source_name": "string",
    "work_source_type": "DIRECT",
    "start_time": "2022-01-02T05:11:24.148Z",
    "update_time": "2022-01-02T06:11:24.148Z",
    "trace_id": "string",
    "engine_ids": [ … ],
    "tags": [ … ],
    "engines": [ … ],
    "account_id": 1,
    "account_name": "User 1",
    "compliance_node_id": "string",
    "compliance_node_name": "string",
    "percent_complete": 50,
    "virtualization_tasks": [ … ],
    "tasks": [ … ],
    "execution_id": "string",
    "result_type": "string",
    "result": {},
    "parent_job_id": "string"
  }
}