Flagsmith Admin API

naftiko: 1.0.0-alpha2
info:
  label: Flagsmith Admin API
  description: The Flagsmith Admin API allows developers to programmatically manage all aspects of their Flagsmith projects.
    Anything that can be done through the Flagsmith dashboard can also be accomplished via this API, including creating, updating,
    and deleting projects, environments, feature flags, segments, and users. It uses a secret Organisation API Token for authentication
    and provides a Swagger interface at api.flagsmith.com/api/v1/docs for interactive exploration.
  tags:
  - Flagsmith
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: flagsmith
    baseUri: https://api.flagsmith.com/api/v1
    description: Flagsmith Admin API HTTP API.
    authentication:
      type: apikey
      in: header
      name: Authorization
      value: '{{FLAGSMITH_TOKEN}}'
    resources:
    - name: organisations
      path: /organisations/
      operations:
      - name: listorganisations
        method: GET
        description: List organisations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organisations-organisation-id
      path: /organisations/{organisation_id}/
      operations:
      - name: getorganisation
        method: GET
        description: Get an organisation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects
      path: /projects/
      operations:
      - name: listprojects
        method: GET
        description: List projects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createproject
        method: POST
        description: Create a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects-project-id
      path: /projects/{project_id}/
      operations:
      - name: getproject
        method: GET
        description: Get a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateproject
        method: PUT
        description: Update a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteproject
        method: DELETE
        description: Delete a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments
      path: /environments/
      operations:
      - name: listenvironments
        method: GET
        description: List environments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key
      path: /environments/{environment_api_key}/
      operations:
      - name: getenvironment
        method: GET
        description: Get an environment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updateenvironment
        method: PUT
        description: Update an environment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects-project-id-features
      path: /projects/{project_id}/features/
      operations:
      - name: listfeatures
        method: GET
        description: List features for a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createfeature
        method: POST
        description: Create a feature flag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects-project-id-features-feature-id
      path: /projects/{project_id}/features/{feature_id}/
      operations:
      - name: getfeature
        method: GET
        description: Get a feature flag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatefeature
        method: PUT
        description: Update a feature flag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletefeature
        method: DELETE
        description: Delete a feature flag
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key-featurestates
      path: /environments/{environment_api_key}/featurestates/
      operations:
      - name: listfeaturestates
        method: GET
        description: List feature states for an environment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key-featurestates-f
      path: /environments/{environment_api_key}/featurestates/{feature_state_id}/
      operations:
      - name: updatefeaturestate
        method: PATCH
        description: Update a feature state
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects-project-id-segments
      path: /projects/{project_id}/segments/
      operations:
      - name: listsegments
        method: GET
        description: List segments for a project
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createsegment
        method: POST
        description: Create a segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: projects-project-id-segments-segment-id
      path: /projects/{project_id}/segments/{segment_id}/
      operations:
      - name: getsegment
        method: GET
        description: Get a segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatesegment
        method: PUT
        description: Update a segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deletesegment
        method: DELETE
        description: Delete a segment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key-identities
      path: /environments/{environment_api_key}/identities/
      operations:
      - name: listidentities
        method: GET
        description: List identities for an environment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key-identities-iden
      path: /environments/{environment_api_key}/identities/{identity_id}/
      operations:
      - name: getidentity
        method: GET
        description: Get an identity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteidentity
        method: DELETE
        description: Delete an identity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organisations-organisation-id-users
      path: /organisations/{organisation_id}/users/
      operations:
      - name: listorganisationusers
        method: GET
        description: List organisation users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: environments-environment-api-key-webhooks
      path: /environments/{environment_api_key}/webhooks/
      operations:
      - name: listenvironmentwebhooks
        method: GET
        description: List environment webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createenvironmentwebhook
        method: POST
        description: Create an environment webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organisations-organisation-id-webhooks
      path: /organisations/{organisation_id}/webhooks/
      operations:
      - name: listorganisationwebhooks
        method: GET
        description: List organisation webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createorganisationwebhook
        method: POST
        description: Create an organisation webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: flagsmith-rest
    description: REST adapter for Flagsmith Admin API.
    resources:
    - path: /organisations/
      name: listorganisations
      operations:
      - method: GET
        name: listorganisations
        description: List organisations
        call: flagsmith.listorganisations
        outputParameters:
        - type: object
          mapping: $.
    - path: /organisations/{organisation_id}/
      name: getorganisation
      operations:
      - method: GET
        name: getorganisation
        description: Get an organisation
        call: flagsmith.getorganisation
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/
      name: listprojects
      operations:
      - method: GET
        name: listprojects
        description: List projects
        call: flagsmith.listprojects
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/
      name: createproject
      operations:
      - method: POST
        name: createproject
        description: Create a project
        call: flagsmith.createproject
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/
      name: getproject
      operations:
      - method: GET
        name: getproject
        description: Get a project
        call: flagsmith.getproject
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/
      name: updateproject
      operations:
      - method: PUT
        name: updateproject
        description: Update a project
        call: flagsmith.updateproject
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/
      name: deleteproject
      operations:
      - method: DELETE
        name: deleteproject
        description: Delete a project
        call: flagsmith.deleteproject
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/
      name: listenvironments
      operations:
      - method: GET
        name: listenvironments
        description: List environments
        call: flagsmith.listenvironments
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/
      name: getenvironment
      operations:
      - method: GET
        name: getenvironment
        description: Get an environment
        call: flagsmith.getenvironment
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/
      name: updateenvironment
      operations:
      - method: PUT
        name: updateenvironment
        description: Update an environment
        call: flagsmith.updateenvironment
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/features/
      name: listfeatures
      operations:
      - method: GET
        name: listfeatures
        description: List features for a project
        call: flagsmith.listfeatures
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/features/
      name: createfeature
      operations:
      - method: POST
        name: createfeature
        description: Create a feature flag
        call: flagsmith.createfeature
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/features/{feature_id}/
      name: getfeature
      operations:
      - method: GET
        name: getfeature
        description: Get a feature flag
        call: flagsmith.getfeature
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/features/{feature_id}/
      name: updatefeature
      operations:
      - method: PUT
        name: updatefeature
        description: Update a feature flag
        call: flagsmith.updatefeature
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/features/{feature_id}/
      name: deletefeature
      operations:
      - method: DELETE
        name: deletefeature
        description: Delete a feature flag
        call: flagsmith.deletefeature
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/featurestates/
      name: listfeaturestates
      operations:
      - method: GET
        name: listfeaturestates
        description: List feature states for an environment
        call: flagsmith.listfeaturestates
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/featurestates/{feature_state_id}/
      name: updatefeaturestate
      operations:
      - method: PATCH
        name: updatefeaturestate
        description: Update a feature state
        call: flagsmith.updatefeaturestate
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/segments/
      name: listsegments
      operations:
      - method: GET
        name: listsegments
        description: List segments for a project
        call: flagsmith.listsegments
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/segments/
      name: createsegment
      operations:
      - method: POST
        name: createsegment
        description: Create a segment
        call: flagsmith.createsegment
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/segments/{segment_id}/
      name: getsegment
      operations:
      - method: GET
        name: getsegment
        description: Get a segment
        call: flagsmith.getsegment
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/segments/{segment_id}/
      name: updatesegment
      operations:
      - method: PUT
        name: updatesegment
        description: Update a segment
        call: flagsmith.updatesegment
        outputParameters:
        - type: object
          mapping: $.
    - path: /projects/{project_id}/segments/{segment_id}/
      name: deletesegment
      operations:
      - method: DELETE
        name: deletesegment
        description: Delete a segment
        call: flagsmith.deletesegment
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/identities/
      name: listidentities
      operations:
      - method: GET
        name: listidentities
        description: List identities for an environment
        call: flagsmith.listidentities
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/identities/{identity_id}/
      name: getidentity
      operations:
      - method: GET
        name: getidentity
        description: Get an identity
        call: flagsmith.getidentity
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/identities/{identity_id}/
      name: deleteidentity
      operations:
      - method: DELETE
        name: deleteidentity
        description: Delete an identity
        call: flagsmith.deleteidentity
        outputParameters:
        - type: object
          mapping: $.
    - path: /organisations/{organisation_id}/users/
      name: listorganisationusers
      operations:
      - method: GET
        name: listorganisationusers
        description: List organisation users
        call: flagsmith.listorganisationusers
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/webhooks/
      name: listenvironmentwebhooks
      operations:
      - method: GET
        name: listenvironmentwebhooks
        description: List environment webhooks
        call: flagsmith.listenvironmentwebhooks
        outputParameters:
        - type: object
          mapping: $.
    - path: /environments/{environment_api_key}/webhooks/
      name: createenvironmentwebhook
      operations:
      - method: POST
        name: createenvironmentwebhook
        description: Create an environment webhook
        call: flagsmith.createenvironmentwebhook
        outputParameters:
        - type: object
          mapping: $.
    - path: /organisations/{organisation_id}/webhooks/
      name: listorganisationwebhooks
      operations:
      - method: GET
        name: listorganisationwebhooks
        description: List organisation webhooks
        call: flagsmith.listorganisationwebhooks
        outputParameters:
        - type: object
          mapping: $.
    - path: /organisations/{organisation_id}/webhooks/
      name: createorganisationwebhook
      operations:
      - method: POST
        name: createorganisationwebhook
        description: Create an organisation webhook
        call: flagsmith.createorganisationwebhook
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: flagsmith-mcp
    transport: http
    description: MCP adapter for Flagsmith Admin API for AI agent use.
    tools:
    - name: listorganisations
      description: List organisations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listorganisations
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganisation
      description: Get an organisation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getorganisation
      outputParameters:
      - type: object
        mapping: $.
    - name: listprojects
      description: List projects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listprojects
      outputParameters:
      - type: object
        mapping: $.
    - name: createproject
      description: Create a project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.createproject
      outputParameters:
      - type: object
        mapping: $.
    - name: getproject
      description: Get a project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getproject
      outputParameters:
      - type: object
        mapping: $.
    - name: updateproject
      description: Update a project
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: flagsmith.updateproject
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteproject
      description: Delete a project
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: flagsmith.deleteproject
      outputParameters:
      - type: object
        mapping: $.
    - name: listenvironments
      description: List environments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listenvironments
      outputParameters:
      - type: object
        mapping: $.
    - name: getenvironment
      description: Get an environment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getenvironment
      outputParameters:
      - type: object
        mapping: $.
    - name: updateenvironment
      description: Update an environment
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: flagsmith.updateenvironment
      outputParameters:
      - type: object
        mapping: $.
    - name: listfeatures
      description: List features for a project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listfeatures
      outputParameters:
      - type: object
        mapping: $.
    - name: createfeature
      description: Create a feature flag
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.createfeature
      outputParameters:
      - type: object
        mapping: $.
    - name: getfeature
      description: Get a feature flag
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getfeature
      outputParameters:
      - type: object
        mapping: $.
    - name: updatefeature
      description: Update a feature flag
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: flagsmith.updatefeature
      outputParameters:
      - type: object
        mapping: $.
    - name: deletefeature
      description: Delete a feature flag
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: flagsmith.deletefeature
      outputParameters:
      - type: object
        mapping: $.
    - name: listfeaturestates
      description: List feature states for an environment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listfeaturestates
      outputParameters:
      - type: object
        mapping: $.
    - name: updatefeaturestate
      description: Update a feature state
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.updatefeaturestate
      outputParameters:
      - type: object
        mapping: $.
    - name: listsegments
      description: List segments for a project
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listsegments
      outputParameters:
      - type: object
        mapping: $.
    - name: createsegment
      description: Create a segment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.createsegment
      outputParameters:
      - type: object
        mapping: $.
    - name: getsegment
      description: Get a segment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getsegment
      outputParameters:
      - type: object
        mapping: $.
    - name: updatesegment
      description: Update a segment
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: flagsmith.updatesegment
      outputParameters:
      - type: object
        mapping: $.
    - name: deletesegment
      description: Delete a segment
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: flagsmith.deletesegment
      outputParameters:
      - type: object
        mapping: $.
    - name: listidentities
      description: List identities for an environment
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listidentities
      outputParameters:
      - type: object
        mapping: $.
    - name: getidentity
      description: Get an identity
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.getidentity
      outputParameters:
      - type: object
        mapping: $.
    - name: deleteidentity
      description: Delete an identity
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: flagsmith.deleteidentity
      outputParameters:
      - type: object
        mapping: $.
    - name: listorganisationusers
      description: List organisation users
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listorganisationusers
      outputParameters:
      - type: object
        mapping: $.
    - name: listenvironmentwebhooks
      description: List environment webhooks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listenvironmentwebhooks
      outputParameters:
      - type: object
        mapping: $.
    - name: createenvironmentwebhook
      description: Create an environment webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.createenvironmentwebhook
      outputParameters:
      - type: object
        mapping: $.
    - name: listorganisationwebhooks
      description: List organisation webhooks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: flagsmith.listorganisationwebhooks
      outputParameters:
      - type: object
        mapping: $.
    - name: createorganisationwebhook
      description: Create an organisation webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: flagsmith.createorganisationwebhook
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    FLAGSMITH_TOKEN: FLAGSMITH_TOKEN