Skip to navigation

Update a trajectory import

Use expected_revision to reject a stale update. Example request: {"expected_revision":1,"name":"Updated support traces"}.

Authentication

AuthorizationApi-Key

Type "Api-Key" followed by a space and the project API key.

Path parameters

agent_uuidstringRequired
Agent UUID
import_uuidstringRequired
Trajectory import UUID

Request

Import update
expected_revisionintegerOptional
ExpectedRevision is the current import revision.
learn_frombooleanOptional
LearnFrom is the new learning setting, when supplied.
mappingobjectOptional

Mapping is the new mapping, when supplied. Example: {"task_family":{"source":"fixed","value":"support"}}.

namestringOptional
Name is the new import name, when supplied.
on_source_changestringOptional
OnSourceChange is the new change policy, when supplied.
require_reviewbooleanOptional
RequireReview is the new review setting, when supplied.
scheduleobjectOptional

Schedule is the new schedule, when supplied. Example: {"interval_hours":4,"start_from":"24h","settle_minutes":5,"max_open_hours":24}.

selectionobjectOptional

Selection is the new selection, when supplied. Example: {"trace_ids":["trace_123"]}.

Response

OK
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.
statusstringOptional
Status is the import status.
updated_atstringOptional
UpdatedAt is the last resource update time.
uuidstringOptional
UUID is the trajectory import identifier.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error