--- updatedAt: 2026-06-11T21:38:37.000Z agentTools: projectIndex: https://docs.atono.io/llms.txt --- # Get a feature flag # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Atono API", "version": "0.1" }, "servers": [ { "url": "https://api.atono.io", "description": "Atono API" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/api/v1/flags/{id}": { "get": { "tags": [ "Flags" ], "summary": "Get a feature flag", "operationId": "fetchFlag", "parameters": [ { "name": "id", "in": "path", "description": "The UUID or key of the feature flag. The key is the feature flag name shown in the UI.", "required": true, "schema": { "type": "string" }, "example": "amazing_feature" } ], "responses": { "200": { "description": "Successfully retrieved the flag and its included relationships.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SingleResourceBody_FlagResource_" } } }, "links": { "self": { "operationId": "fetchFlag", "parameters": { "id": "$response.body#/data/id" } }, "listFlagConfigurations": { "operationId": "listFlagConfigurations", "parameters": { "id": "$response.body#/data/id" } }, "fetchFlagEnvironmentConfiguration": { "operationId": "fetchFlagEnvironmentConfiguration", "parameters": { "id": "$response.body#/data/id", "environmentId": "$response.body#/data/relationships/slices/data/0/id" } }, "updateFlagEnvironmentConfiguration": { "operationId": "updateFlagEnvironmentConfiguration", "parameters": { "id": "$response.body#/data/id", "environmentId": "$response.body#/data/relationships/slices/data/0/id" } } } }, "404": { "description": "The flag could not be found, or one of the requested related resources (include) does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NoResourceBody" } } } } } } } }, "components": { "schemas": { "FlagResource": { "description": "A feature flag controls the behavior of a feature in Atono. It includes a unique name (key), a list of possible variants, a summary of what the flag controls, and environment-specific configuration (slices) that determines how the flag evaluates across environments.", "properties": { "type": { "type": "string", "default": "flag", "description": "Identifies the type of resource.", "pattern": "flag", "defaultValue": "flag" }, "id": { "type": "string", "format": "uuid", "description": "The unique identifier for the resource, typically a UUID." }, "attributes": { "allOf": [ { "$ref": "#/components/schemas/FlagResource.Attributes" } ], "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps." }, "relationships": { "allOf": [ { "$ref": "#/components/schemas/FlagResource.Relationships" } ], "description": "Contains references to other related resources." } }, "readOnly": true }, "FlagResource.Attributes": { "description": "Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.", "properties": { "key": { "type": "string", "description": "The flag name used to identify this feature flag in your codebase or SDK configuration. This name is unique within your workspace." }, "summary": { "type": "string", "description": "A human-readable summary describing what this flag controls. Useful for understanding the intent or behavior behind the flag." }, "variants": { "additionalProperties": true, "description": "A list of named variants the flag can evaluate to. Each variant maps to a value used in your application. For boolean flags, variants include `\"on\": true` and `\"off\": false`." }, "createdAt": { "type": "string", "format": "date-time", "description": "The date and time the feature flag was created." }, "updatedAt": { "type": "string", "format": "date-time", "description": "The date and time the feature flag was last updated." } } }, "FlagResource.Relationships": { "description": "Contains references to other related resources.", "properties": { "slices": { "allOf": [ { "$ref": "#/components/schemas/MultipleRelationships" } ], "description": "A relationship object linking to the environment-specific configurations for the flag. Includes a reference to each environment (slice), along with related links and metadata. Each slice defines the variant the flag will evaluate to in that environment." } } }, "MultipleRelationships": { "properties": { "links": { "$ref": "#/components/schemas/RelationshipLinks" }, "data": { "type": [ "array", "null" ], "items": { "$ref": "#/components/schemas/ResourceIdentifier" } }, "meta": { "additionalProperties": true } }, "required": [ "data", "links", "meta" ] }, "NoResourceBody": { "properties": { "errors": { "type": "array", "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.", "items": { "$ref": "#/components/schemas/ProblemDetail", "description": "A problem detail object is a way to convey information about an error that occurred while processing a request." } }, "meta": { "additionalProperties": true, "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values." }, "included": { "type": "array", "description": "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).", "items": {} }, "links": { "additionalProperties": { "type": "string", "format": "uri" }, "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`." } }, "readOnly": true }, "ProblemDetail": { "description": "A problem detail object is a way to convey information about an error that occurred while processing a request.", "properties": { "id": { "type": "string", "description": "A unique identifier for this specific error occurrence. Useful for debugging and support." }, "links": { "additionalProperties": { "type": "string", "format": "uri" }, "allOf": [ { "type": [ "null", "object" ] } ], "description": "Links related to the error. May include a URL to relevant documentation or support resources." }, "status": { "type": "integer", "format": "int32", "description": "The HTTP status code associated with the error (e.g., 400, 404, 422)." }, "code": { "type": "string", "description": "An internal code that identifies the type or category of the error." }, "title": { "type": "string", "description": "A short summary of the problem." }, "source": { "type": [ "null", "object" ], "allOf": [ { "$ref": "#/components/schemas/ProblemSource" } ], "readOnly": true }, "detail": { "type": "string", "description": "Additional information about the error, intended to provide more context than the title." }, "meta": { "additionalProperties": true, "description": "Additional information about the error, which may be useful for debugging. The contents vary depending on the error type." } }, "readOnly": true }, "ProblemSource": { "description": "Identifies the part of the request that caused the error. Only one source is present per error.", "properties": { "pointer": { "type": [ "string", "null" ], "description": "Specifies the path to the field in the request body that caused the error." }, "parameter": { "type": [ "string", "null" ], "description": "Identifies a query parameter in the request URL that caused the error." }, "header": { "type": [ "string", "null" ], "description": "Identifies the request header that caused the error." } }, "readOnly": true }, "RelationshipLinks": { "properties": { "self": { "type": [ "string", "null" ], "format": "uri" }, "related": { "type": [ "string", "null" ], "format": "uri" } }, "required": [ "related", "self" ] }, "ResourceIdentifier": { "properties": { "type": { "type": "string", "description": "Identifies the type of the linked resource." }, "id": { "type": "string", "description": "The unique identifier of the linked resource." } }, "required": [ "id", "type" ] }, "SingleResourceBody_FlagResource_": { "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/FlagResource" } ], "description": "The returned resource, based on the request." }, "errors": { "type": "array", "description": "A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.", "items": { "$ref": "#/components/schemas/ProblemDetail", "description": "A problem detail object is a way to convey information about an error that occurred while processing a request." } }, "meta": { "additionalProperties": true, "description": "Additional contextual information about the response. May include summary data such as item counts, timestamps, or other calculated values." }, "included": { "type": "array", "description": "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).", "items": {} }, "links": { "additionalProperties": { "type": "string", "format": "uri" }, "description": "Pagination or navigation links related to the response. May include keys such as `self`, `next`, `prev`, `first`, or `last`." } }, "readOnly": true } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "name": "X-API-KEY", "in": "header" } } } } ```