Import (create or update) investors on a project.

post

https://k1creator-publicapi.k1x.io/v1/projects/{projectId}/investors

Validates and upserts every investor in the supplied list onto the project identified by
projectId, which must belong to the tenant your API key resolves to. The
import is atomic: if any record fails validation the whole request is rejected and nothing is
written. Existing investors that are omitted from the payload are left untouched — this
endpoint never deletes. Use dryRun=true to validate a payload without applying it.

Supply investorId to update an existing investor, or leave it unset to create one.
The optional externalId you send on each record is echoed back on the response so you
can map your own identifiers to the Creator-assigned investorId.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

projectId

int32

required

The project to import investors into.

Query Params

dryRun

boolean

When true, validation runs but no changes are applied.

Body Params

The investor records to create or update.

The body of an investor import request: the set of investors to create or update on a project.
Wrapping the collection in an object (rather than accepting a bare array) lets structural
per-record validation run — a top-level array parameter bypasses FluentValidation auto-validation.

investors

array of objects

The investor records to create or update. At least one is required.

investors

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

200The payload was valid; the summary reports the applied rows and their identifiers.

400One or more records failed validation; no rows were written.

404No project exists with the given identifier, it has been deleted, or it belongs to another tenant.