---
title: "Create a Flag"
method: POST
path: "/api/feature/flags"
tags: ["Feature Flags"]
---

# Create a Flag

`POST /api/feature/flags`

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/api/feature/flags`
- Auth: API key in header `X-API-KEY`

Create a feature flag

## Request body

- RequestFeatureFlagCreateResource
  - `data` FeatureFlagCreateResource, required
    - `type` string, required
    - `attributes` FeatureFlagCreateResourceAttributes, required
      - `key` string, required
      - `summary` string, required
      - `isActive` boolean, required
      - `valueType` 'BOOLEAN', required
      - `variants` unknown, required
      - `defaultVariant` string, required
    - `relationships` FeatureFlagCreateResourceRelationships, required
      - `backlogItems` MultipleRelationshipsUpdate, required
        - `data` ResourceIdentifier[], required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.

## Response `200`

The flag

- SingleResourceBodyFeatureFlagResource
  - `data` FeatureFlagResource
    - `type` string, required
    - `id` string, required
    - `attributes` FeatureFlagResourceAttributes, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `key` string, required
      - `summary` string, required
      - `isActive` boolean, required
      - `valueType` 'BOOLEAN', required
      - `variants` unknown, required
      - `defaultVariant` string, required
    - `relationships` FeatureFlagResourceRelationships, required
      - `backlogItems` MultipleRelationships, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier[], nullable, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `rules` MultipleRelationships, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier[], nullable, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `flippers` MultipleRelationships, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier[], nullable, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `owners` MultipleRelationships, required
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier[], nullable, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
    - `meta` FeatureFlagResourceMetadata, required
      - `state` 'REGULAR' | 'SAMPLE_DATA' | 'JIRA_SYNC', required: Represents the state of an entity in the system.
      - `evaluationMetrics` FeatureFlagResourceEvaluationMetrics, required
        - `acrossEnvironments` FeatureFlagResourceLatestEvaluations, required
          - `state` 'NEVER_EVALUATED' | 'SINGLE_VARIANT' | 'MIXED_VARIANTS' | 'NO_LONGER_EVALUATED', required
          - `perVariant` unknown, required
        - `perEnvironment` unknown, required
      - `lastUpdate` string, date-time, required
      - `allowedActions` string[], required
  - `errors` ProblemDetail[]: A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.
    - `id` string: A unique identifier for this specific error occurrence. Useful for debugging and support.
    - `links` object, nullable: Links related to the error. May include a URL to relevant documentation or support resources.
    - `status` integer: The HTTP status code associated with the error (e.g., 400, 404, 422).
    - `code` string: An internal code that identifies the type or category of the error.
    - `title` string: A short summary of the problem.
    - `source` ProblemSource: Identifies the part of the request that caused the error. Only one source is present per error.
      - `pointer` string, nullable: Specifies the path to the field in the request body that caused the error.
      - `parameter` string, nullable: Identifies a query parameter in the request URL that caused the error.
      - `header` string, nullable: Identifies the request header that caused the error.
    - `detail` string: Additional information about the error, intended to provide more context than the title.
    - `meta` unknown
  - `meta` unknown
  - `included` unknown[]: A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).
    - unknown
  - `links` unknown

## Other responses

- `404`: One or more backlog items couldn't be found.
- `409`: A flag with the same key already exist.
- `500`: Unexpected error

---

[API](https://skmtc.dev/atono/apis/backend-api.md) · [All operations](https://skmtc.dev/atono/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atono/apis/backend-api/revisions/78a57b1d8c3d?raw)