Get audit logs by scope
Query audit logs at the workspace, organization or environment level, with optional filtering and pagination.
Authorization
AccessToken Use access token to access this API. Example: "Authorization: api-MzQ..."
In: header
Query Parameters
Required. Allowed values (case-sensitive): Environment, Organization, Workspace. Workspace queries are not currently supported and return 403.
Required. The environment, organization or workspace ID corresponding to scope. Must not be an empty GUID.
uuidOptional. Allowed values (case-sensitive): FeatureFlag, Segment, Member, Group, Policy. Defaults to the types currently supported by the scope: FeatureFlag and Segment for Environment; Member, Group and Policy for Organization. Types must match the scope. Multiple values match any selected type. Example: refTypes=FeatureFlag&refTypes=Segment.
Optional resource ID, such as a feature flag or segment ID. Used to get audit logs for a specific resource.
Optional user or access token ID. Omit to query logs from all creators.
uuidOptional text to search for in the log keyword or comment. Matching is case-insensitive.
Optional inclusive start time, expressed as Unix milliseconds. Omit for no lower time limit.
^-?(?:0|[1-9]\d*)$int64Optional inclusive end time, expressed as Unix milliseconds. Must not precede from. Omit for no upper time limit.
^-?(?:0|[1-9]\d*)$int64Only used to query audit logs for a specific shared segment across environments. Defaults to false.
^-?(?:0|[1-9]\d*)$int32^-?(?:0|[1-9]\d*)$int32Header Parameters
The organization ID associated with the request. Some APIs require this header to identify the organization context. When authenticating with an Access Token, this header is automatically populated from the token and does not need to be provided manually.
The workspace ID associated with the request. Some APIs require this header to identify the workspace context. When authenticating with an Access Token, this header is automatically populated from the token and does not need to be provided manually.
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/audit-logs"{ "success": true, "errors": [ "string" ], "data": null}