POST/api/v1/feature-flags

Evaluate feature flags with custom context

Evaluates requested/all flags with optional custom context payload; requires session user.

Request body

Content type: application/json · schema FeatureFlagsPostBodyV1

flagsarray of string

itemsstring

contextobject

userRolestring

companySizestring

Enum: smallmediumlargeenterprise

subscriptionPlanstring

customPropertiesobject

Response body

Success response 200 · schema MetaUtilityApiSuccessV1

dataanyOf

anyOf (option 1)object

anyOf (option 2)array of object

itemsobject

anyOf (option 3)string

anyOf (option 4)number

anyOf (option 5)boolean

anyOf (option 6)null

flagsobject

contextobject

enabledboolean

reasonstring

usageStatsEnabledboolean

controlledBystring

messagestring

successboolean

Response codes

200

Operation succeeded.

400

Invalid request payload/query.

401

Unauthorized (API key/session auth failure depending on route).

403

Permission denied.

500

Unexpected route/controller failure.

POST /api/v1/feature-flags

cURL

curl -X POST "https://algapsa.com/api/v1/feature-flags" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "flags": [
    "string"
  ],
  "context": {
    "userRole": "string",
    "companySize": "small",
    "subscriptionPlan": "string",
    "customProperties": {}
  }
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/feature-flags", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "flags": [
      "string"
    ],
    "context": {
      "userRole": "string",
      "companySize": "small",
      "subscriptionPlan": "string",
      "customProperties": {}
    }
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/feature-flags");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""flags"": [
    ""string""
  ],
  ""context"": {
    ""userRole"": ""string"",
    ""companySize"": ""small"",
    ""subscriptionPlan"": ""string"",
    ""customProperties"": {}
  }
}", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {},
  "flags": {},
  "context": {},
  "enabled": false,
  "reason": "string",
  "usageStatsEnabled": false,
  "controlledBy": "string",
  "message": "string",
  "success": false
}