Create a tag

Base URL: https://{kibana_url}

POST /api/tags
POST /s/{space_id}/api/tags

Auth

Creates a new tag and returns it.

Path parameters

space_id string optional: An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.

Header parameters

kbn-xsrf string required: A required header to protect against CSRF attacks

Request body

color string · min length: 1 · max length: 256: The tag color as a hex value (e.g. #772299). If omitted, a random color is generated.
description string · max length: 2048: Optional description of the tag.
name string · min length: 1 · max length: 256 required: The display name of the tag.

Responses

created

application/json

data object required
id string required: The tag ID.
meta object required

400

invalid request

403

forbidden

409

conflict

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn:/api/tags
{
  "color": "#F04E98",
  "description": "Content related to security investigations.",
  "name": "Security"
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/api/tags" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "color": "#F04E98",
    "description": "Content related to security investigations.",
    "name": "Security"
  }'

Generated from the API spec

Response

{
  "data": {
    "color": "#F04E98",
    "description": "Content related to security investigations.",
    "name": "Security"
  },
  "id": "tag-security",
  "meta": {
    "created_at": "2026-06-03T14:15:00.000Z",
    "managed": false,
    "updated_at": "2026-06-03T14:15:00.000Z",
    "version": "WzMsMV0="
  }
}