For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Create a scheduled import or queue a one-time import. Example request: {"connection_uuid":"8c78a85e-eac2-4f57-b5f5-59a68a1e77a1","provider_project_id":"project-123","name":"Support traces","selection":{"trace_ids":["trace-123"]},"mapping":{"task_family":{"source":"fixed","value":"support"}}}.
Authentication
AuthorizationApi-Key
Type "Api-Key" followed by a space and the project API key.
Path parameters
agent_uuidstringRequired
Agent UUID
Request
Import request
connection_uuidstringOptional
ConnectionUUID identifies the project trace connection.
learn_frombooleanOptional
LearnFrom controls whether imported evidence can support Skills.
mappingobjectOptional
Mapping defines how source traces become Trajectories. Example: {"task_family":{"source":"fixed","value":"support"}}.
namestringOptional
Name is the import display name.
on_source_changestringOptional
OnSourceChange defines how changed source traces are handled.
provider_project_idstringOptional
ProviderProjectID is the source provider project identifier.
require_reviewbooleanOptional
RequireReview requires review for candidates backed by this import.
scheduleobjectOptional
Schedule enables recurring imports when supplied. Example: {"interval_hours":4,"start_from":"24h","settle_minutes":5,"max_open_hours":24}.
selectionobjectOptional
Selection defines the traces to import. Example: {"trace_ids":["trace_123"]}.
Response
Created
agent_uuidstringOptional
AgentUUID is the owning Agent identifier.
connection_uuidstringOptional
ConnectionUUID is the trace connection identifier.
created_atstringOptional
CreatedAt is the resource creation time.
imported_trajectory_countintegerOptional
ImportedTrajectoryCount is the number of Trajectories currently owned by this import.
last_runobjectOptional
LastRun is the latest run for this import, when one exists.
learn_frombooleanOptional
LearnFrom reports whether imported evidence can support Skills.
mappingobjectOptional
Mapping defines how traces become Trajectories. Example: {"task_family":{"source":"fixed","value":"support"}}.
namestringOptional
Name is the import display name.
next_run_atstringOptional
NextRunAt is the next scheduled run time.
on_source_changestringOptional
OnSourceChange defines how changed source traces are handled.
pause_reasonenumOptional
PauseReason is the reason for a paused import, when present.
Allowed values:
providerstringOptional
Provider is the observability provider.
provider_organization_idstringOptional
ProviderOrganizationID is the provider organization identifier.
provider_project_idstringOptional
ProviderProjectID is the source project identifier.
require_reviewbooleanOptional
RequireReview reports whether candidate review is required.
revisionintegerOptional
Revision is the import update revision.
scheduleobjectOptional
Schedule contains recurring import settings, when enabled. Example: {"interval_hours":4,"start_from":"24h","settle_minutes":5,"max_open_hours":24}.
selectionobjectOptional
Selection defines the source traces to import. Example: {"trace_ids":["trace_123"]}.
source_cursor_updated_atstringOptional
SourceCursorUpdatedAt is the last source cursor update time.
