Enterprise Observability

Log delivery lets you stream logs to your own cloud storage. Each logging configuration defines a source (currently only available in the cda) and a destination bucket, and Contentful will deliver compressed NDJSON log files on a regular schedule. Read more on Enterprise Observability here.

Logging Configurations Collection

Get all logging configurations

Returns a paginated collection of logging configurations for the organization.

Create Logging Configuration

Create a logging configuration

Creates a new logging configuration for the organization. The name and source fields are required, along with a destination type and matching credentials.

AWS S3 credentials require bucketName, iamArn, and region.

Logging Configuration

Get a single logging configuration

Get a single logging configuration

Returns a single logging configuration by ID.

Delete a logging configuration

Delete a logging configuration

Deletes a logging configuration. This stops future log deliveries for the configuration.

Logging Configuration Status

Use this endpoint to monitor the delivery history for a configuration. It returns a cursor-paginated list of individual delivery attempts, each showing whether the attempt succeeded or failed.

Delivery status records are retained for 180 days.

Get configuration delivery status

Get configuration delivery status

Logging Configuration Credentials

Update logging configuration credentials

Update logging configuration credentials

Replaces the credentials for an existing logging configuration. The request body must match the destination type of the existing configuration — you cannot change the destination type via this endpoint.

AWS S3 credentials require bucketName, iamArn, and region.