---
title: "Create a log configuration"
method: POST
path: "/controlplane/log/config"
tags: ["Log config"]
---

# Create a log configuration

`POST /controlplane/log/config`

Creates a new log configuration or overwrites an existing one, replacing any previous values.

## Request body

- LogConfigCreate
  - `is_default` true | false, required — Defines whether this log configuration is the default. > > **Note**: If true, it requires the `agent:log_config:create-default` permission; otherwise, it requires `agent:log_config:create`. >
  - `expires_at` string — If the log configuration is not default, an expiration date must be specified.
  - `account_id` integer — Applicable if the log specification is at the account level.
  - `selector` object, required — The tags to be matched to apply the log configuration
  - `configuration` object, required — The log configuration as defined in the log specification.

## Response `200`

The operation was successful.

- LogConfig
  - `is_default` true | false — Defines whether this log configuration is the default. > > **Note**: If true, it requires the `agent:log_config:create-default` permission; otherwise, it requires `agent:log_config:create`. >
  - `expires_at` string — If the log configuration is not default, an expiration date must be specified.
  - `account_id` integer — Applicable if the log specification is at the account level.
  - `selector` object — The tags to be matched to apply the log configuration.
  - `configuration` object — The log configuration as defined in the log specification.
  - `created_configuration_defaults` ConfigurationDefault[]
    - `template_id` string
    - `template_name` string
    - `capability_category` string
    - `capability_provider` string
    - `default_configuration_id` string

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)