Logs

A Log instance resource represents a log entry made by FreeClimb in the course of processing a PerCL script or servicing a REST API request. It is mostly useful for debugging purposes. The Logs list resource represents the set of logs generated for an account.

For convenience, a Logs list resource is also available as a subresource of a Call instance resource, since most logging occurs during call processing.

The Log instance resource is unusual in that it exists but is not directly addressable. It also does not have a resource ID.

Resource properties

Property

Type

Description

timestamp

integer

Time that the log was generated. The time is represented as microseconds since the Unix Epoch.

level

string

Level of the log. Possible values are info, warning, and error.

requestId

string

ID of the request associated with the log. It also appears in the Request-Id HTTP header found in all webhook invocations. This value is propagated across all logs generated by FreeClimb when processing a request.

accountId

string

ID of the account that this log was generated under.

callId

string

ID of the Call associated with the log. Can be set to null if the log was generated without regard to a specific Call.

message

string

A simple string describing the event being logged.

metadata

object

JSON document containing metadata about the event. Some log messages may include request and response header content in this field.