List an Organization's Flag Logs

GET /api/0/organizations/{organization_id_or_slug}/flags/logs/

Return a paginated list of feature flag changes (creations, updates and deletions) recorded for an organization within the requested time range.

Path Parameters

organization_id_or_slug (string) REQUIRED: The ID or slug of the organization the resource belongs to.

Query Parameters:

start (string)

The start of the period of time for the query, expected in ISO-8601 format. For example, 2001-12-14T12:34:56.7890.

end (string)

The end of the period of time for the query, expected in ISO-8601 format. For example, 2001-12-14T12:34:56.7890.

statsPeriod (string)

The period of time for the query, will override the start & end parameters, a number followed by one of:

d for days
h for hours
m for minutes
s for seconds
w for weeks

For example, 24h, to mean query data starting from 24 hours ago to now.

flag (array(string))

The name of a feature flag to filter by. Repeat the parameter to match multiple flags.

provider (array(string))

choices:

flagpole
generic
launchdarkly
statsig
unknown
unleash

The flag provider to filter by. Use unknown to match logs without a provider. Repeat the parameter to match multiple providers.

sort (string)

The field to sort results by.

Available fields are:

action
createdAt
createdBy
createdByType
flag
provider

Prefix with - to sort in descending order.

per_page (integer)

Limit the number of rows to return in the result. Default and maximum allowed is 100.

cursor (string)

A pointer to the last object fetched and its sort order; used to retrieve the next or previous results.

Scopes

You need to authenticate via bearer auth token.

<auth_token> requires one of the following scopes:

org:admin
org:read
org:write

Copied

curl https://sentry.io/api/0/organizations/{organization_id_or_slug}/flags/logs/ \
 -H 'Authorization: Bearer <auth_token>'

RESPONSESCHEMA

Copied
{
  "data": [
    {
      "id": 1,
      "action": "updated",
      "createdAt": "2024-01-01T05:12:33.000000+00:00",
      "createdBy": "jane.doe@example.com",
      "createdByType": "email",
      "flag": "new-checkout-flow",
      "provider": "launchdarkly",
      "tags": {
        "environment": "production"
      }
    }
  ]
}

Was this helpful?