Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Statsig Console Tags API
description: The Statsig Console API enables developers to programmatically manage their Statsig project configuration. It supports full CRUD operations on feature gates, dynamic configs, experiments, segments, layers, holdouts, autotunes, metrics, keys, users, tags, target apps, audit logs, and other entities. The API requires a Console API Key and uses versioned endpoints with the STATSIG-API-VERSION header. It is designed for automation workflows such as bulk configuration edits, syncing definitions into Statsig from external systems, and integrating Statsig management into CI/CD pipelines.
version: '20240601'
contact:
name: Statsig Support
url: https://statsig.com/support
termsOfService: https://statsig.com/terms
servers:
- url: https://statsigapi.net/console/v1
description: Statsig Console API Server
security:
- consoleApiKey: []
tags:
- name: Tags
paths:
/tags:
get:
operationId: listTags
summary: List all tags
description: Retrieves a list of all tags used for organizing entities in the project.
tags:
- Tags
parameters:
- $ref: '#/components/parameters/ApiVersion'
responses:
'200':
description: List of tags
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Tag'
'401':
$ref: '#/components/responses/Unauthorized'
post:
operationId: createTag
summary: Create a tag
description: Creates a new tag for organizing entities in the project.
tags:
- Tags
parameters:
- $ref: '#/components/parameters/ApiVersion'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TagCreate'
responses:
'201':
description: Tag created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/Tag'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
components:
responses:
BadRequest:
description: Invalid request parameters
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error message describing what was wrong with the request.
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
type: object
properties:
message:
type: string
description: Error message describing the authentication failure.
schemas:
TagCreate:
type: object
description: Request body for creating a new tag.
required:
- name
properties:
name:
type: string
description: The name of the tag to create.
description:
type: string
description: A human-readable description.
color:
type: string
description: The color for the tag.
Tag:
type: object
description: A tag used for organizing and categorizing entities.
properties:
id:
type: string
description: The unique identifier of the tag.
name:
type: string
description: The name of the tag.
description:
type: string
description: A human-readable description.
color:
type: string
description: The color associated with the tag for display.
parameters:
ApiVersion:
name: STATSIG-API-VERSION
in: header
required: false
schema:
type: string
default: '20240601'
description: The Console API version. Currently the only version is 20240601.
securitySchemes:
consoleApiKey:
type: apiKey
in: header
name: STATSIG-API-KEY
description: Console API Key created in Project Settings > API Keys tab. Required for all Console API requests.
externalDocs:
description: Statsig Console API Documentation
url: https://docs.statsig.com/console-api/