Configure log export destination

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

curl --request PUT \
  --url https://api.telnyx.com/v2/compute/funcs/{id}/logs/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "endpoint": "https://api.honeycomb.io/v1/logs",
  "headers": {
    "x-honeycomb-team": "abc123"
  },
  "runtime_export_enabled": true,
  "invocation_export_enabled": true
}
'

{
  "data": {
    "record_type": "compute_func_log_export_config",
    "id": "cfg-1",
    "func_id": "6b7e8f9a-1c2d-3e4f-5a6b-7c8d9e0f1a2b",
    "endpoint": "https://api.honeycomb.io/v1/logs",
    "enabled": true,
    "runtime_export_enabled": true,
    "invocation_export_enabled": true,
    "created_at": "2026-09-18T14:30:00.000Z",
    "updated_at": "2026-09-21T18:00:00.000Z"
  }
}

{
  "data": {
    "record_type": "compute_func_log_export_config",
    "id": "cfg-1",
    "func_id": "6b7e8f9a-1c2d-3e4f-5a6b-7c8d9e0f1a2b",
    "endpoint": "https://api.honeycomb.io/v1/logs",
    "enabled": true,
    "runtime_export_enabled": true,
    "invocation_export_enabled": true,
    "created_at": "2026-09-21T18:00:00.000Z",
    "updated_at": "2026-09-21T18:00:00.000Z"
  }
}

{
  "errors": [
    {
      "code": "10020",
      "title": "Unprocessable entity",
      "detail": "Request could not be processed."
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "Unauthorized",
      "detail": "Invalid or missing API key."
    }
  ]
}

{
  "errors": [
    {
      "code": "10005",
      "title": "Resource not found",
      "detail": "The requested resource or URL could not be found."
    }
  ]
}

{
  "errors": [
    {
      "code": "10020",
      "title": "Unprocessable entity",
      "detail": "Request could not be processed: this endpoint is a full replace — endpoint, headers, runtime_export_enabled, and invocation_export_enabled are all required on every call."
    }
  ]
}

{
  "errors": [
    {
      "code": "10010",
      "title": "Internal server error",
      "detail": "An unexpected error occurred."
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Function ID

Body

application/json

Full-replace configuration body. All fields are required on every call: the API treats PUT as a replace (RFC 7231), so omitting any field is a 422, not "keep the current value".

endpoint

string<uri>

required

HTTPS URL to push logs to

headers

object

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.

Show child attributes

runtime_export_enabled

boolean

required

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

invocation_export_enabled

boolean

required

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

Response

Log export configuration replaced successfully

data

object

Metadata-only view of a function's log export destination. Header values are write-only (encrypted server-side) and never appear in any response.

Show child attributes

curl --request PUT \
  --url https://api.telnyx.com/v2/compute/funcs/{id}/logs/export \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "endpoint": "https://api.honeycomb.io/v1/logs",
  "headers": {
    "x-honeycomb-team": "abc123"
  },
  "runtime_export_enabled": true,
  "invocation_export_enabled": true
}
'

{
  "data": {
    "record_type": "compute_func_log_export_config",
    "id": "cfg-1",
    "func_id": "6b7e8f9a-1c2d-3e4f-5a6b-7c8d9e0f1a2b",
    "endpoint": "https://api.honeycomb.io/v1/logs",
    "enabled": true,
    "runtime_export_enabled": true,
    "invocation_export_enabled": true,
    "created_at": "2026-09-18T14:30:00.000Z",
    "updated_at": "2026-09-21T18:00:00.000Z"
  }
}

{
  "data": {
    "record_type": "compute_func_log_export_config",
    "id": "cfg-1",
    "func_id": "6b7e8f9a-1c2d-3e4f-5a6b-7c8d9e0f1a2b",
    "endpoint": "https://api.honeycomb.io/v1/logs",
    "enabled": true,
    "runtime_export_enabled": true,
    "invocation_export_enabled": true,
    "created_at": "2026-09-21T18:00:00.000Z",
    "updated_at": "2026-09-21T18:00:00.000Z"
  }
}

{
  "errors": [
    {
      "code": "10020",
      "title": "Unprocessable entity",
      "detail": "Request could not be processed."
    }
  ]
}

{
  "errors": [
    {
      "code": "10001",
      "title": "Unauthorized",
      "detail": "Invalid or missing API key."
    }
  ]
}

{
  "errors": [
    {
      "code": "10005",
      "title": "Resource not found",
      "detail": "The requested resource or URL could not be found."
    }
  ]
}

{
  "errors": [
    {
      "code": "10020",
      "title": "Unprocessable entity",
      "detail": "Request could not be processed: this endpoint is a full replace — endpoint, headers, runtime_export_enabled, and invocation_export_enabled are all required on every call."
    }
  ]
}

{
  "errors": [
    {
      "code": "10010",
      "title": "Internal server error",
      "detail": "An unexpected error occurred."
    }
  ]
}

Overview

Get Started

Best Practices

Guides

Local Development

Configuration

CI/CD

Custom Domains

Runtime APIs

Observability

CLI

Platform

For AI Agents

Configure log export destination

Authorizations

Path Parameters

Body

Response