functions

Configure log export destination

Changed on

Configures the external OTLP endpoint a function's runtime and/or invocation logs are pushed to as they happen. This operation is a full replace, not a patch: endpoint, headers, runtime_export_enabled, and invocation_export_enabled are all required on every call — omitting any of them is a 422, not "keep the current value". Headers are encrypted at rest and never returned in any response.

The endpoint must be an HTTPS URL. When export is configured, new log records are converted to OTLP log records and delivered continuously; export never bypasses platform log storage, and delivery retries with a bounded policy while the destination is unreachable. Only logs generated after configuration are exported — there is no historical replay.

put/compute/funcs/{id}/logs/export

Request

  • Base URL
    https://api.telnyx.com/v2
  • URL
    https://api.telnyx.com/v2/compute/funcs/{id}/logs/export
  • Auth
    HTTP bearer

Path parameters

idstring required

Function ID

Request body

endpointstring uri required

HTTPS URL to push logs to

headersobject required

Headers attached to every export push, as key-value pairs (e.g. an auth token the collector expects). Required even when empty — {} means "no headers". Encrypted at rest; never returned.

runtime_export_enabledboolean required

Export runtime logs (function stdout/stderr) to this destination

invocation_export_enabledboolean required

Export invocation records (one per HTTP request) to this destination

Response

Log export configuration replaced successfully

Changes

  • 67df31283a8aRevision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a72569d69430Revision changes
    • info

      endpoint added