Skip to navigation
SDK ReferenceTrace Connections

Create a trace connection

Verify the provider credential before Zep stores it. Example request: {"name":"Support traces","provider":"braintrust","credential":"secret","requests_per_minute":10}.

Authentication

AuthorizationApi-Key

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

Request

Connection request
api_urlstringOptional
APIURL is an optional custom provider endpoint.
credentialstringOptional

Credential is the write-only provider credential.

namestringOptional
Name is the connection name.
providerstringOptional
Provider is the provider name.
requests_per_minuteintegerOptional
RequestsPerMinute is the provider request rate limit.
retention_daysintegerOptional
RetentionDays is an optional provider retention window.

Response

Created
created_atstringOptional
CreatedAt is the resource creation time.
credential_hintstringOptional
CredentialHint contains the final four characters of the credential.
credential_versionintegerOptional
CredentialVersion is the current credential version.
import_countintegerOptional

ImportCount is the number of non-deleted imports that use this connection.

last_verified_atstringOptional
LastVerifiedAt is the last successful credential verification time.
namestringOptional
Name is the display name.
providerstringOptional
Provider is the observability provider.
provider_organization_idstringOptional
ProviderOrganizationID is the provider organization identifier.
provider_organization_namestringOptional
ProviderOrganizationName is the provider organization name.
settingsobjectOptional

Settings contains provider request and retention settings. Example: {"requests_per_minute":10}.

statusstringOptional
Status is the provider verification status.
updated_atstringOptional
UpdatedAt is the last resource update time.
uuidstringOptional
UUID is the trace connection identifier.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error