Targeting

Targeting allows you to enable Feature Flags for specific users or organizations. When a flag is enabled for a target, that target will receive the flag’s enabled value instead of the default value.

List enabled feature flags for an organization

Get a list of all enabled feature flags for an organization.

JavaScript

 import { WorkOS } from '@workos-inc/node';

const workos = new WorkOS('sk_example_123456789');

const featureFlags = await workos.organizations.listOrganizationFeatureFlags({
  organizationId: 'org_01EHZNVPK3SFK441A1RGBFSHRT',
});

console.log(featureFlags.data);

 {
  "object": "list",
  "data": [
    {
      "object": "feature_flag",
      "id": "flag_01EHZNVPK3SFK441A1RGBFSHRT",
      "slug": "advanced-analytics",
      "name": "Advanced Analytics",
      "description": "Enable advanced analytics dashboard feature",
      "owner": {
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe"
      },
      "tags": [
        "reports"
      ],
      "enabled": true,
      "default_value": false,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z"
    }
  ],
  "list_metadata": {
    "before": "flag_01HXYZ123456789ABCDEFGHIJ",
    "after": "flag_01HXYZ987654321KJIHGFEDCBA"
  }
}

GET

`/organizations/:organizationId/feature-flags`

`Parameters`

`Returns` `object`

List enabled feature flags for a user

Get a list of all enabled feature flags for the provided user. This includes feature flags enabled specifically for the user as well as any organizations that the user is a member of.

JavaScript

 import { WorkOS } from '@workos-inc/node';

const workos = new WorkOS('sk_example_123456789');

const featureFlags = await workos.userManagement.listUserFeatureFlags({
  userId: 'user_01EHZNVPK3SFK441A1RGBFSHRT',
});

console.log(featureFlags.data);

 {
  "object": "list",
  "data": [
    {
      "object": "feature_flag",
      "id": "flag_01EHZNVPK3SFK441A1RGBFSHRT",
      "slug": "advanced-analytics",
      "name": "Advanced Analytics",
      "description": "Enable advanced analytics dashboard feature",
      "owner": {
        "email": "jane@example.com",
        "first_name": "Jane",
        "last_name": "Doe"
      },
      "tags": [
        "reports"
      ],
      "enabled": true,
      "default_value": false,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z"
    }
  ],
  "list_metadata": {
    "before": "flag_01HXYZ123456789ABCDEFGHIJ",
    "after": "flag_01HXYZ987654321KJIHGFEDCBA"
  }
}

GET

`/user_management/users/:userId/feature-flags`

`Parameters`

`Returns` `object`

Add a feature flag target

Enables a feature flag for a specific target in the current environment. Currently, supported targets include users and organizations.

Request

JavaScript

 curl --request POST \
  --url https://api.workos.com/feature-flags/test-flag/targets/org_01EHZNVPK3SFK441A1RGBFSHRT \
  --header "Authorization: Bearer sk_example_123456789"

 import { WorkOS } from '@workos-inc/node';

const workos = new WorkOS('sk_example_123456789');

await workos.featureFlags.addFlagTarget({
  slug: 'test-flag',
  targetId: 'org_01EHZNVPK3SFK441A1RGBFSHRT',
});

 require "workos"

WorkOS.configure do |config|
  config.api_key = "sk_example_123456789"
end

WorkOS.client.feature_flags.add_flag_target(
  resource_id: "user_01234567890abcdef",
  slug: "beta-feature"
)

 from workos import WorkOSClient

client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789")

client.feature_flags.add_flag_target(
    resource_id="user_01234567890abcdef", slug="beta-feature"
)

 package main

import (
	"context"

	"github.com/workos/workos-go/v9"
)

func main() {
	client := workos.NewClient("sk_example_123456789")

	_, err := client.FeatureFlags().AddFlagTarget(context.Background(), "user_01234567890abcdef", "beta-feature")
	if err != nil {
		panic(err)
	}
}

 <?php

use WorkOS\WorkOS;

$workos = new WorkOS(
    apiKey: "sk_example_123456789",
    clientId: "client_123456789",
);

$workos
    ->featureFlags()
    ->addFlagTarget(resourceId: "user_01234567890abcdef", slug: "beta-feature");

 import com.workos.WorkOS;

WorkOS workos = new WorkOS("sk_example_123456789");

workos.featureFlags.addFlagTarget("user_01234567890abcdef", "beta-feature");

 using WorkOS;

var client = new WorkOSClient(new WorkOSOptions {
    ApiKey = "sk_example_123456789",
    ClientId = "client_123456789",
});

await client.FeatureFlags.AddFlagTargetAsync("user_01234567890abcdef", "beta-feature");

 use workos::Client;

#[tokio::main]
async fn main() -> Result<(), workos::Error> {
    let client = Client::builder()
        .api_key("sk_example_123456789")
        .client_id("client_123456789")
        .build();

    let _result = client
        .feature_flags()
        .add_flag_target(
            "user_01234567890abcdef",
            "beta-feature"
        )
        .await?;

    Ok(())
}

POST

`/feature-flags/:slug/targets/:resourceId`

`Parameters`

`Returns`

Remove a feature flag target

Removes a target from the feature flag’s target list in the current environment. Currently, supported targets include users and organizations.

Request

JavaScript

 curl --request DELETE \
  --url https://api.workos.com/feature-flags/test-flag/targets/org_01EHZNVPK3SFK441A1RGBFSHRT \
  --header "Authorization: Bearer sk_example_123456789"

 import { WorkOS } from '@workos-inc/node';

const workos = new WorkOS('sk_example_123456789');

await workos.featureFlags.removeFlagTarget({
  slug: 'test-flag',
  targetId: 'org_01EHZNVPK3SFK441A1RGBFSHRT',
});

 require "workos"

WorkOS.configure do |config|
  config.api_key = "sk_example_123456789"
end

WorkOS.client.feature_flags.remove_flag_target(
  resource_id: "user_01234567890abcdef",
  slug: "beta-feature"
)

 from workos import WorkOSClient

client = WorkOSClient(api_key="sk_example_123456789", client_id="client_123456789")

client.feature_flags.remove_flag_target(
    resource_id="user_01234567890abcdef", slug="beta-feature"
)

 package main

import (
	"context"

	"github.com/workos/workos-go/v9"
)

func main() {
	client := workos.NewClient("sk_example_123456789")

	_, err := client.FeatureFlags().RemoveFlagTarget(context.Background(), "user_01234567890abcdef", "beta-feature")
	if err != nil {
		panic(err)
	}
}

 <?php

use WorkOS\WorkOS;

$workos = new WorkOS(
    apiKey: "sk_example_123456789",
    clientId: "client_123456789",
);

$workos
    ->featureFlags()
    ->removeFlagTarget(
        resourceId: "user_01234567890abcdef",
        slug: "beta-feature",
    );

 import com.workos.WorkOS;

WorkOS workos = new WorkOS("sk_example_123456789");

workos.featureFlags.removeFlagTarget("user_01234567890abcdef", "beta-feature");

 using WorkOS;

var client = new WorkOSClient(new WorkOSOptions {
    ApiKey = "sk_example_123456789",
    ClientId = "client_123456789",
});

await client.FeatureFlags.RemoveFlagTargetAsync("user_01234567890abcdef", "beta-feature");

 use workos::Client;

#[tokio::main]
async fn main() -> Result<(), workos::Error> {
    let client = Client::builder()
        .api_key("sk_example_123456789")
        .client_id("client_123456789")
        .build();

    let _result = client
        .feature_flags()
        .remove_flag_target(
            "user_01234567890abcdef",
            "beta-feature"
        )
        .await?;

    Ok(())
}

DELETE

`/feature-flags/:slug/targets/:resourceId`

`Parameters`

`Returns`

Multi-Factor Auth Continue to the next section

Up next

Targeting

List enabled feature flags for an organization

/organizations/:organizationId/feature-flags

Parameters

organizationId: string

before?: string

after?: string

limit?: integer

order?: "normal" | "desc" | "asc"

Returns object

object: "list"

data: object[]

list_metadata: object

List enabled feature flags for a user

/user_management/users/:userId/feature-flags

Parameters

userId: string

before?: string

after?: string

limit?: integer

order?: "normal" | "desc" | "asc"

Returns object

object: "list"

data: object[]

list_metadata: object

Add a feature flag target

/feature-flags/:slug/targets/:resourceId

Parameters

resourceId: string

slug: string

Returns

empty: empty

Remove a feature flag target

/feature-flags/:slug/targets/:resourceId

Parameters

resourceId: string

slug: string

Returns

empty: empty

`/organizations/:organizationId/feature-flags`

`Parameters`

`Returns` `object`

`/user_management/users/:userId/feature-flags`

`Parameters`

`Returns` `object`

`/feature-flags/:slug/targets/:resourceId`

`Parameters`

`Returns`

`/feature-flags/:slug/targets/:resourceId`

`Parameters`

`Returns`