# Flagmint Docs

## Docs

- [Create a new API key](https://docs.flagmint.com/api-reference/api-keys/create-a-new-api-key.md)
- [List API keys for a project](https://docs.flagmint.com/api-reference/api-keys/list-api-keys-for-a-project.md)
- [Revoke an API key](https://docs.flagmint.com/api-reference/api-keys/revoke-an-api-key.md)
- [Create custom attribute](https://docs.flagmint.com/api-reference/attributes/create-custom-attribute.md): Creates a new custom attribute
- [Deactivate attribute](https://docs.flagmint.com/api-reference/attributes/deactivate-attribute.md): Deactivates an attribute (works for both system and custom attributes)
- [Delete custom attribute](https://docs.flagmint.com/api-reference/attributes/delete-custom-attribute.md): Deletes a custom attribute (system attributes cannot be deleted)
- [Get attribute](https://docs.flagmint.com/api-reference/attributes/get-attribute.md): Retrieves a single attribute by its key
- [List attributes](https://docs.flagmint.com/api-reference/attributes/list-attributes.md): Retrieves a list of attributes with optional filters
- [Update custom attribute](https://docs.flagmint.com/api-reference/attributes/update-custom-attribute.md): Updates an existing custom attribute (system attributes cannot be modified)
- [Get audit logs](https://docs.flagmint.com/api-reference/audit/get-audit-logs.md): Retrieve audit logs from Redis stream and/or database with filtering and pagination.
- [Get audit logs export status](https://docs.flagmint.com/api-reference/audit/get-audit-logs-export-status.md): Retrieves the status of a previously requested audit logs export. Returns download URL when completed.
- [Get audit statistics](https://docs.flagmint.com/api-reference/audit/get-audit-statistics.md): Get statistics about audit logs in Redis stream and database.
- [Get auditevent types](https://docs.flagmint.com/api-reference/audit/get-auditevent-types.md)
- [Request audit logs export](https://docs.flagmint.com/api-reference/audit/request-audit-logs-export.md): Queues an export of audit logs as CSV with optional filters. Returns 202 Accepted with status URL. Rate limited to 1 export per 10 minutes per user.
- [Authentication](https://docs.flagmint.com/api-reference/authentication.md): Coming soon.
- [Get a single invoice](https://docs.flagmint.com/api-reference/billing/get-a-single-invoice.md): Returns a single invoice by ID, scoped to the organization.
- [Get billingportal](https://docs.flagmint.com/api-reference/billing/get-billingportal.md): Generate a **short-lived Stripe Billing Portal session** for an organization admin.       This portal link allows the admin to manage billing-related tasks securely within Stripe's hosted UI.
- [Get current month usage for organization](https://docs.flagmint.com/api-reference/billing/get-current-month-usage-for-organization.md): Returns API calls, flags, and projects usage with their limits
- [List invoices for an organization](https://docs.flagmint.com/api-reference/billing/list-invoices-for-an-organization.md): Returns all invoices for the given organization, ordered by date descending.
- [Post billingsession](https://docs.flagmint.com/api-reference/billing/post-billingsession.md)
- [Stripe webhook handler](https://docs.flagmint.com/api-reference/billing/stripe-webhook-handler.md): Verifies and processes Stripe billing events.
- [Submit a custom plan inquiry](https://docs.flagmint.com/api-reference/billing/submit-a-custom-plan-inquiry.md): Public endpoint — no auth required. Captures org context when the caller is authenticated. Rate limited to 3 submissions per IP per day.
- [Create Plant](https://docs.flagmint.com/api-reference/endpoint/create.md)
- [Delete Plant](https://docs.flagmint.com/api-reference/endpoint/delete.md)
- [Get Plants](https://docs.flagmint.com/api-reference/endpoint/get.md)
- [New Plant](https://docs.flagmint.com/api-reference/endpoint/webhook.md)
- [Environments](https://docs.flagmint.com/api-reference/environments.md): Coming soon.
- [Errors](https://docs.flagmint.com/api-reference/errors.md): Coming soon.
- [Evaluation Endpoint](https://docs.flagmint.com/api-reference/evaluate.md): Evaluate feature flags for a given context via the REST API.
- [Evaluate feature flags using an API key](https://docs.flagmint.com/api-reference/evaluation/evaluate-feature-flags-using-an-api-key.md)
- [Create targeting rule](https://docs.flagmint.com/api-reference/flag-targeting-rules/create-targeting-rule.md): Create a new targeting rule for a flag in an environment.
- [Delete targeting rule](https://docs.flagmint.com/api-reference/flag-targeting-rules/delete-targeting-rule.md): Soft delete a targeting rule.
- [Get targeting rule](https://docs.flagmint.com/api-reference/flag-targeting-rules/get-targeting-rule.md): Fetch details for a specific targeting rule.
- [List targeting rules](https://docs.flagmint.com/api-reference/flag-targeting-rules/list-targeting-rules.md): Fetch all targeting rules for a specific flag in an environment. Rules are returned ordered by order_index (ascending) then created_at.
- [Reorder targeting rules](https://docs.flagmint.com/api-reference/flag-targeting-rules/reorder-targeting-rules.md): Reorder targeting rules for a specific flag.
- [Update targeting rule](https://docs.flagmint.com/api-reference/flag-targeting-rules/update-targeting-rule.md): Update an existing targeting rule.
- [Delete flag value](https://docs.flagmint.com/api-reference/flag-values/delete-flag-value.md): Note: This resource is soft-deleted using a **deleted_at** timestamp.  Deleted data will be **permanently removed** after 90 days.  You can still retrieve and export it within that window using an admin interface or API.
- [Get flag value](https://docs.flagmint.com/api-reference/flag-values/get-flag-value.md): Fetch the full configuration of a flag in a specific project + environment.   **Access:** Viewers, Editors, Admins, or SDKs with read-only token for the project.   Returns the flag’s value, type, targeting rules, and rollout strategy.
- [Delete projects flags variations](https://docs.flagmint.com/api-reference/flag-variations/delete-projects-flags-variations.md): Delete a variation. Variation cannot be deleted if in use by targeting rules or rollouts.
- [Get projects flags variations](https://docs.flagmint.com/api-reference/flag-variations/get-projects-flags-variations.md): List all variations for a feature flag, ordered by order_index.
- [Put projects flags variations](https://docs.flagmint.com/api-reference/flag-variations/put-projects-flags-variations.md): Update a variation's properties. Setting is_default=true will unset other defaults.
- [Put projects flags variationsreorder](https://docs.flagmint.com/api-reference/flag-variations/put-projects-flags-variationsreorder.md): Reorder variations for a flag. All variations must be included in the payload.
- [Delete projects flags](https://docs.flagmint.com/api-reference/flags/delete-projects-flags.md): Soft-delete a feature flag.
- [Get flags metrics](https://docs.flagmint.com/api-reference/flags/get-flags-metrics.md): Get evaluation metrics for a feature flag.
- [Get projects environments flags](https://docs.flagmint.com/api-reference/flags/get-projects-environments-flags.md): Fetch all flags with their values for a specific environment (with pagination).
- [Get projects flags](https://docs.flagmint.com/api-reference/flags/get-projects-flags.md): List all flags in a project (with pagination). Archived and deleted flags are excluded.
- [Get projects flags 1](https://docs.flagmint.com/api-reference/flags/get-projects-flags-1.md): Get a single feature flag by ID.
- [Post projects flags](https://docs.flagmint.com/api-reference/flags/post-projects-flags.md): Create a new feature flag in a project. **Rate Limited:** Maximum 20 requests per organization per hour.
- [Put projects flags](https://docs.flagmint.com/api-reference/flags/put-projects-flags.md): Update a feature flag's name, key, type, or description.
- [API Reference](https://docs.flagmint.com/api-reference/introduction.md): Complete API documentation for Flagmint feature flag management
- [Get contextsobserved contexts](https://docs.flagmint.com/api-reference/observability/get-contextsobserved-contexts.md): Paginated list of observed contexts (last 30 days)
- [Add organization billing information](https://docs.flagmint.com/api-reference/organization-billing/add-organization-billing-information.md)
- [Cancel scheduled organization deletion](https://docs.flagmint.com/api-reference/organizations/cancel-scheduled-organization-deletion.md): Cancels a scheduled deletion and restores the organization to active status. Only works if deletion hasn't been executed yet. Requires org admin access.
- [Get an organization by ID](https://docs.flagmint.com/api-reference/organizations/get-an-organization-by-id.md): Retrieves a single organization’s full record by ID. Requires authentication and the user must be an admin or editor within the organization.
- [Get organization export status](https://docs.flagmint.com/api-reference/organizations/get-organization-export-status.md): Retrieves the status of a previously requested organization data export. Returns download URL when completed. Requires org admin access.
- [List all active organizations](https://docs.flagmint.com/api-reference/organizations/list-all-active-organizations.md): Returns a list of all non-deleted organizations. Restricted to support admin users.
- [List organization members](https://docs.flagmint.com/api-reference/organizations/list-organization-members.md): Returns a paginated list of all members in the organization. Requires authentication and organization admin role.
- [Register a new organization and admin user](https://docs.flagmint.com/api-reference/organizations/register-a-new-organization-and-admin-user.md): Public route to register a new organization and its initial admin user. No authentication required. Optional query params: price (Stripe price ID) and product (Stripe product ID) to select a specific plan.
- [Request organization data export](https://docs.flagmint.com/api-reference/organizations/request-organization-data-export.md): Queues a complete export of organization data for compliance and backup purposes. Returns 202 Accepted with status URL. Rate limited to 1 export per hour per organization. Requires org admin access.
- [Revoke a member's organization access](https://docs.flagmint.com/api-reference/organizations/revoke-a-members-organization-access.md): Revokes a user's membership in the organization. Requires organization admin role. Sends notification email to the revoked member.
- [Set up an organization for an authenticated user](https://docs.flagmint.com/api-reference/organizations/set-up-an-organization-for-an-authenticated-user.md): Authenticated route for users who need onboarding (e.g. after social login). Creates an org and admin membership in a single transaction. Supports optional plan pricing via query parameters (price & product).
- [Soft delete an organization](https://docs.flagmint.com/api-reference/organizations/soft-delete-an-organization.md): Marks an organization as deleted by setting the `deleted_at` field. Requires org admin access. Data is retained for compliance or export.
- [Update organization details](https://docs.flagmint.com/api-reference/organizations/update-organization-details.md): Updates the organization's name, billing email, or metadata.
- [Delete plan limitsplans](https://docs.flagmint.com/api-reference/plans/delete-plan-limitsplans.md): Delete a subscription plan by ID. Accessible only to support admins.
- [Get plan limitsplans](https://docs.flagmint.com/api-reference/plans/get-plan-limitsplans.md): List all available plans in the system. Accessible only to support admins.
- [Get plan limitsplans 1](https://docs.flagmint.com/api-reference/plans/get-plan-limitsplans-1.md): Retrieve a single plan by ID. Accessible only to support admins.
- [Post plan limitsplans](https://docs.flagmint.com/api-reference/plans/post-plan-limitsplans.md): Create a new subscription plan. Accessible only to support admins.
- [Put plan limitsplans](https://docs.flagmint.com/api-reference/plans/put-plan-limitsplans.md): Update an existing subscription plan by ID. Accessible only to support admins.
- [Delete projects](https://docs.flagmint.com/api-reference/project/delete-projects.md): Archive a project by ID. Requires editor role. Project must belong to the same organization.
- [Get project](https://docs.flagmint.com/api-reference/project/get-project.md): Get a single project by ID. Must belong to the same organization. Requires editor role.
- [Get projects](https://docs.flagmint.com/api-reference/project/get-projects.md): List all projects for the current organization with pagination. Supports optional search by name or project key. Requires editor role.
- [Get projects analytics distribution](https://docs.flagmint.com/api-reference/project/get-projects-analytics-distribution.md): Get per-flag evaluation share for the project.
- [Get projects analytics evaluations](https://docs.flagmint.com/api-reference/project/get-projects-analytics-evaluations.md): Get daily evaluation counts aggregated across all flags in the project.
- [Get projects analytics metrics](https://docs.flagmint.com/api-reference/project/get-projects-analytics-metrics.md): Get project-level evaluation analytics with period-over-period comparison.
- [Get projects analytics response time](https://docs.flagmint.com/api-reference/project/get-projects-analytics-response-time.md): Get daily weighted-average response time across all flags in the project.
- [Get projects analytics top flags](https://docs.flagmint.com/api-reference/project/get-projects-analytics-top-flags.md): Get top flags ranked by evaluation count with error rate and avg response time.
- [Post projects](https://docs.flagmint.com/api-reference/project/post-projects.md): Create a new project in the current organization. Requires editor role and must not exceed the plan's project limit.
- [Put projects](https://docs.flagmint.com/api-reference/project/put-projects.md): Update a project's name or description. Requires editor role. Project must belong to the same organization.
- [Submit a Contact Sales form](https://docs.flagmint.com/api-reference/public/submit-a-contact-sales-form.md): Public endpoint — no auth required. Submits a sales inquiry, verifies the Cloudflare Turnstile token, and sends notification + confirmation emails. Rate limited to 3 requests per IP per 15 minutes and 2 per email per hour.
- [Create rollout](https://docs.flagmint.com/api-reference/rollouts/create-rollout.md): Create a new rollout configuration for a flag in a specific environment.
- [Delete rollout](https://docs.flagmint.com/api-reference/rollouts/delete-rollout.md): Soft-delete a rollout. Will reject if any targeting rules reference this rollout.
- [Get rollout](https://docs.flagmint.com/api-reference/rollouts/get-rollout.md): Get a single rollout by ID.
- [List rollouts](https://docs.flagmint.com/api-reference/rollouts/list-rollouts.md): List all rollouts for a flag in an environment.
- [Update rollout](https://docs.flagmint.com/api-reference/rollouts/update-rollout.md): Update an existing rollout configuration.
- [Create a new segment](https://docs.flagmint.com/api-reference/segments/create-a-new-segment.md): Creates a new audience segment with custom targeting rules. Segments are reusable groups of users defined by conditions (e.g., country='US' AND plan='premium') that can be referenced across multiple feature flags for consistent targeting. Each segment contains an array of conditions combined using a…
- [Delete a segment](https://docs.flagmint.com/api-reference/segments/delete-a-segment.md): Performs a soft delete on a segment, marking it as deleted without permanently removing it from the database. This endpoint will fail with a 409 Conflict error if the segment is currently referenced by any active feature flag targeting rules, preventing accidental breakage of flag evaluation logic.…
- [Get segment details](https://docs.flagmint.com/api-reference/segments/get-segment-details.md): Retrieves complete details for a specific segment including all targeting conditions, logical operator (AND/OR), metadata, and usage information. Returns the full segment configuration with attribute names, operators (eq, neq, in, nin, gt, lt, exists, not_exists), comparison values for each conditio…
- [Get segment usage](https://docs.flagmint.com/api-reference/segments/get-segment-usage.md): Retrieves information about which feature flags are currently using this segment in their targeting rules. Returns the total usage count and a list of flags with their associated environments. Use this endpoint before modifying or deleting a segment to understand its impact across your feature flag…
- [List segments](https://docs.flagmint.com/api-reference/segments/list-segments.md): Retrieves a paginated list of all audience segments defined within a project. Returns segment metadata including name, key, description, rule count, and creation/update timestamps. Supports pagination for efficient handling of large segment catalogs. Use this endpoint to browse available segments be…
- [Update a segment](https://docs.flagmint.com/api-reference/segments/update-a-segment.md): Updates an existing segment's configuration including name, description, key, logical operator (AND/OR), and targeting conditions. Changes to segment rules or logical operators immediately affect all feature flags that reference this segment, allowing centralized audience management without updating…
- [Accept invitation and set password](https://docs.flagmint.com/api-reference/users/accept-invitation-and-set-password.md)
- [Authenticate with Google](https://docs.flagmint.com/api-reference/users/authenticate-with-google.md): Verify a Google ID token and issue JWT tokens. Handles returning users, invited users, and new user creation.
- [Cancel TUS upload](https://docs.flagmint.com/api-reference/users/cancel-tus-upload.md)
- [Change password (authenticated)](https://docs.flagmint.com/api-reference/users/change-password-authenticated.md): Allow authenticated users to change their password. Requires current password verification for security. Use case: User is logged in and wants to change their password. This endpoint is rate-limited to 5 requests per 15 minutes.
- [Finalize TUS upload](https://docs.flagmint.com/api-reference/users/finalize-tus-upload.md)
- [Get user profile](https://docs.flagmint.com/api-reference/users/get-user-profile.md): Retrieves the authenticated user's profile information.
- [Invite a new user to the organization](https://docs.flagmint.com/api-reference/users/invite-a-new-user-to-the-organization.md)
- [Login a user](https://docs.flagmint.com/api-reference/users/login-a-user.md): Generate AUTH Token for authorized users. This endpoint is rate-limited to 5 requests per minute.
- [Refresh an auth token](https://docs.flagmint.com/api-reference/users/refresh-an-auth-token.md): Generates a new access token and refresh token using a valid refresh token.
- [Request password reset](https://docs.flagmint.com/api-reference/users/request-password-reset.md): Send a password reset email if the user exists. This endpoint is rate-limited to 3 requests per 15 minutes.
- [Reset password (unauthenticated)](https://docs.flagmint.com/api-reference/users/reset-password-unauthenticated.md): Reset user password using a valid reset token sent via email. No authentication required. Use case: User forgot their password and received a password reset link via email. This endpoint is rate-limited to 5 requests per 15 minutes.
- [Update user profile (authenticated)](https://docs.flagmint.com/api-reference/users/update-user-profile-authenticated.md): Allow authenticated users to update their profile information including name, job title, and avatar. Password changes require current password verification. This endpoint is rate-limited to 10 requests per 15 minutes.
- [Upload avatar directly](https://docs.flagmint.com/api-reference/users/upload-avatar-directly.md)
- [Upload chunk (TUS protocol)](https://docs.flagmint.com/api-reference/users/upload-chunk-tus-protocol.md)
- [Verify invitation token](https://docs.flagmint.com/api-reference/users/verify-invitation-token.md)
- [Plans & Pricing](https://docs.flagmint.com/billing/plans.md): Flagmint charges per organisation, not per seat. Free forever on the starter plan.
- [Subscriptions](https://docs.flagmint.com/billing/subscriptions.md): Coming soon.
- [Usage](https://docs.flagmint.com/billing/usage.md): Coming soon.
- [Attributes](https://docs.flagmint.com/concepts/attributes.md): Define the user, organization, and custom attributes used in targeting rules and segments
- [Environments](https://docs.flagmint.com/concepts/environments.md): Coming soon.
- [Feature Flags](https://docs.flagmint.com/concepts/flags.md): Create, configure, and manage feature flags across environments with templates, variations, and targeting rules
- [Organizations](https://docs.flagmint.com/concepts/organisations.md): Set up your organization, manage members, plans, and data exports
- [Projects](https://docs.flagmint.com/concepts/projects.md): Organize your feature flags, environments, and analytics under projects
- [Segments](https://docs.flagmint.com/concepts/segments.md): Define reusable audiences for targeting rules with flexible logical operators
- [Targeting Rules](https://docs.flagmint.com/concepts/targeting-rules.md): Control who sees what with attribute rules, segments, rollouts, and gradual rollouts
- [Core Concepts](https://docs.flagmint.com/getting-started/concepts.md): Key terms and concepts you'll encounter when working with Flagmint.
- [What is Flagmint?](https://docs.flagmint.com/getting-started/introduction.md): Feature flag management built for European teams. EU data residency, GDPR-native, no per-seat pricing.
- [Inviting Team Members](https://docs.flagmint.com/getting-started/invitation.md): Learn how to invite colleagues to your FlagMint organization and collaborate on feature flags.
- [Quick Start](https://docs.flagmint.com/getting-started/quickstart.md): Create your first feature flag and integrate the Flagmint SDK in minutes
- [Your First Flag](https://docs.flagmint.com/getting-started/your-first-flag.md): Coming soon.
- [Best Practices](https://docs.flagmint.com/resources/best-practices.md): Coming soon.
- [Changelog](https://docs.flagmint.com/resources/changelog.md): Coming soon.
- [Migrate From Launchdarkly](https://docs.flagmint.com/resources/migrate-from-launchdarkly.md): Coming soon.
- [Troubleshooting](https://docs.flagmint.com/resources/troubleshooting.md): Coming soon.
- [Node.js / JavaScript SDK](https://docs.flagmint.com/sdks/nodejs.md): Framework-agnostic JavaScript SDK for evaluating feature flags with pluggable caching and real-time updates
- [React SDK](https://docs.flagmint.com/sdks/react.md): Integrate Flagmint feature flags into your React application.
- [Rest Api](https://docs.flagmint.com/sdks/rest-api.md): Coming soon.
- [Vue.js SDK](https://docs.flagmint.com/sdks/vuejs.md): Feature flag SDK for Vue 2 and Vue 3 applications with real-time updates
- [Data Residency](https://docs.flagmint.com/security/data-residency.md): Coming soon.
- [Dpa](https://docs.flagmint.com/security/dpa.md): Coming soon.
- [Gdpr](https://docs.flagmint.com/security/gdpr.md): Coming soon.
- [Practices](https://docs.flagmint.com/security/practices.md): Coming soon.

## OpenAPI Specs

- [test-simple](https://docs.flagmint.com/pipelines/test-simple.json)
- [test-nullable](https://docs.flagmint.com/pipelines/test-nullable.json)
- [openapi](https://docs.flagmint.com/api-reference/openapi.json)