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.
This page is for version v4 (default).
For other versions, use one of these documentation indexes:
- v4 (default): https://help.getzep.com/v4/llms.txt
- v3: https://help.getzep.com/v3/llms.txt
- v2: https://help.getzep.com/v2/llms.txt
Use expected_revision to reject a stale update. Example request: {"expected_revision":1,"name":"Updated support traces"}. Agent Skills is in closed release. Zep enables Agent Skills only for select accounts. A request from an account without access returns 403 permission_denied. To get access, contact support@getzep.com.
Authentication
AuthorizationApi-Key
Type “Api-Key” followed by a space and the project API key.
Path parameters
agent_uuidstringRequired
Agent UUID
import_uuidstringRequired
Trace 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_changeenumOptional
OnSourceChange is the new change policy, when supplied.
Allowed values:
require_reviewbooleanOptional
RequireReview is the new review setting, when supplied.
scheduleobjectOptional
Schedule is the new schedule, when supplied. Example: {“interval_hours”:4,“start_from”:“now”,“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
The service returns the configured provider connection used by this import.
created_atstringOptional
CreatedAt is the resource creation time.
imported_trace_countintegerOptional
ImportedTraceCount is the number of Traces 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 Traces. 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_changeenumOptional
OnSourceChange defines how changed source traces are handled.
Allowed values:
pause_reasonenumOptional
PauseReason is the reason for a paused import, when present.
Allowed values:
providerenumOptional
Provider is the Braintrust or LangSmith provider.
Allowed values:
provider_organization_idstringOptional
ProviderOrganizationID is the provider organization identifier.
provider_project_idstringOptional
The service returns the provider project selected for this import.
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”:“now”,“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.
