POST/api/v1/feature-access

Check feature access

Checks feature access via ApiPermissionController.checkFeatureAccess() using API key auth and permission read checks.

RBAC · permission

Request body

Content type: application/json · schema FeatureAccessBodyV1

user_idstring <uuid>

feature_namestringRequired

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-access

cURL

curl -X POST "https://algapsa.com/api/v1/feature-access" \
  -H "X-API-Key: $ALGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "user_id": "01HN2K7VRB9PQ3Y0000000000",
  "feature_name": "string"
}'

TypeScript

const response = await fetch("https://algapsa.com/api/v1/feature-access", {
  method: "POST",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "user_id": "01HN2K7VRB9PQ3Y0000000000",
    "feature_name": "string"
  })
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://algapsa.com/api/v1/feature-access");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
request.Headers.TryAddWithoutValidation("Content-Type", "application/json");
request.Content = new StringContent(@"{
  ""user_id"": ""01HN2K7VRB9PQ3Y0000000000"",
  ""feature_name"": ""string""
}", 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
}