Sign in
Imports

Create import

Imports historical traces from another observability platform into the project. The import runs in the background, newest traces first.

post/v1/projects/{projectSlug}/imports

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier)

Request body

sourceProjectIdstring required

Id of the project on the platform to read from.

sourceProjectNamestring

Name of the platform project, shown in Latitude. Defaults to sourceProjectId.

rangeFromstring date-time

ISO-8601 start of the range to import. Defaults to 90 days before rangeTo, bounded by the plan's retention.

rangeTostring date-time

ISO-8601 end of the range to import. Defaults to now.

maxTracesinteger

Most traces to import, newest first. Each imported trace bills one credit. Defaults to the maximum, 100,000.

sessionMetadataKeystring

LangSmith only: run metadata key that groups traces into sessions. Defaults to thread_id.

Response

Import created and started

idstring required

Stable import identifier.

organizationIdstring required

Organization that owns this import.

projectIdstring required

Latitude project the traces are imported into.

source'langfuse' | 'langsmith' | 'braintrust' required

Observability platform the import reads from.

status'created' | 'queued' | 'running' | 'succeeded' | 'capped' | 'cancelled' | 'failed' required

Lifecycle state. created/queued/running are in flight; succeeded finished cleanly; capped stopped at a ceiling with everything before it kept; cancelled and failed can be retried.

errorstring nullable required

Why the import did not finish cleanly, or which ceiling stopped a capped one. status alone says whether it failed.

cancelledAtstring nullable required

ISO-8601 timestamp at which cancellation was requested, or null.

startedAtstring nullable required

ISO-8601 timestamp at which a worker picked the import up, or null.

finishedAtstring nullable required

ISO-8601 timestamp at which the import ended, or null while in flight.

createdAtstring required

ISO-8601 timestamp of creation.

updatedAtstring required

ISO-8601 timestamp of the last update.

Changes

Changed in 1 of the 67 revisions of this API.1