---
title: "Create log specification"
method: POST
path: "/controlplane/log/spec"
tags: ["Log specification"]
---

# Create log specification

`POST /controlplane/log/spec`

Create a new log specification.

## Request body

- LogSpecRequest
  - `organization_id` integer — The ID of the organization.
  - `account_id` integer — The ID of the account.
  - `templates` TemplateSpec[]
    - `capability_category` string
    - `capability_provider` string
    - `template_name` string
    - `add_tags` object
  - `template_vars` object
  - `selector_definition` object
  - `selector` object

## Response `201`

Log specification created successfully.

- LogSpecResponse
  - `id` string — The ID of the log specification.
  - `organization_id` integer — The ID of the organization.
  - `account_id` integer — The ID of the account.
  - `templates` object[]
    - `add_tags` object
    - `template_id` string
    - `template_name` string
    - `capability_category` string
    - `capability_provider` string
  - `template_vars` object
  - `selector_definition` object
  - `selector` object
  - `name` string — The name of the log.
  - `created_at` string, date-time — The ISO-8601 UTC timestamp of when the log was created.
  - `updated_at` string, date-time, nullable — The ISO-8601 UTC timestamp of when the log was last updated.

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Server error responses indicating an issue on the API side.

---

[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)