LaunchDarkly maintains a record of all the changes made to any resource in the system. You can access this history using the audit log API, including filtering by timestamps, or using a custom policy to select which entries to receive.
Several of the endpoints in the audit log API require an audit log entry ID. The audit log entry ID is returned as part of the List audit log entries response. It is the _id
field of each element in the items
array.
In the LaunchDarkly UI, this information appears on the Change history page. To learn more, read Change history.
Get a list of all audit log entries. The query parameters let you restrict the results that return by date ranges, resource specifiers, or a full-text search query.
LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read About the resource specifier syntax.
Audit log entries response
Invalid request
Invalid access token
Forbidden
Rate limited
{- "items": [
- {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "1234a56b7c89d012345e678f",
- "_accountId": "1234a56b7c89d012345e678f",
- "date": 0,
- "accesses": [
- {
- "action": "string",
- "resource": "string"
}
], - "kind": "string",
- "name": "Example feature flag",
- "description": "Example, turning on the flag for testing",
- "shortDescription": "Example, turning on the flag",
- "comment": "This is an automated test",
- "subject": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "avatarUrl": "string"
}, - "member": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "507f1f77bcf86cd799439011",
- "email": "ariel@acme.com",
- "firstName": "Ariel",
- "lastName": "Flores"
}, - "token": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "name": "DevOps token",
- "ending": "2345",
- "serviceToken": false
}, - "app": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "isScim": true,
- "name": "string",
- "maintainerName": "string"
}, - "titleVerb": "turned on the flag",
- "title": "string",
- "target": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "Example flag name",
- "resources": [
- "proj/example-project:env/production:flag/example-flag"
]
}, - "parent": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "resource": "string"
}
}
], - "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}
}
Search your audit log entries. The query parameters let you restrict the results that return by date ranges, or a full-text search query. The request body lets you restrict the results that return by resource specifiers.
LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read About the resource specifier syntax.
Audit log entries response
Invalid request
Invalid access token
Forbidden
Rate limited
[- {
- "resources": [
- "proj/*:env/*:flag/*;testing-tag"
], - "notResources": [
- "string"
], - "actions": [
- "*"
], - "notActions": [
- "string"
], - "effect": "allow"
}
]
{- "items": [
- {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "1234a56b7c89d012345e678f",
- "_accountId": "1234a56b7c89d012345e678f",
- "date": 0,
- "accesses": [
- {
- "action": "string",
- "resource": "string"
}
], - "kind": "string",
- "name": "Example feature flag",
- "description": "Example, turning on the flag for testing",
- "shortDescription": "Example, turning on the flag",
- "comment": "This is an automated test",
- "subject": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "avatarUrl": "string"
}, - "member": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "507f1f77bcf86cd799439011",
- "email": "ariel@acme.com",
- "firstName": "Ariel",
- "lastName": "Flores"
}, - "token": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "name": "DevOps token",
- "ending": "2345",
- "serviceToken": false
}, - "app": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "isScim": true,
- "name": "string",
- "maintainerName": "string"
}, - "titleVerb": "turned on the flag",
- "title": "string",
- "target": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "Example flag name",
- "resources": [
- "proj/example-project:env/production:flag/example-flag"
]
}, - "parent": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "resource": "string"
}
}
], - "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}
}
Fetch a detailed audit log entry representation. The detailed representation includes several fields that are not present in the summary representation, including:
delta
: the JSON patch body that was used in the request to update the entitypreviousVersion
: a JSON representation of the previous version of the entitycurrentVersion
: a JSON representation of the current version of the entityAudit log entry response
Invalid access token
Forbidden
Invalid resource identifier
Rate limited
{- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "1234a56b7c89d012345e678f",
- "_accountId": "1234a56b7c89d012345e678f",
- "date": 0,
- "accesses": [
- {
- "action": "string",
- "resource": "string"
}
], - "kind": "string",
- "name": "Example feature flag",
- "description": "Example, turning on the flag for testing",
- "shortDescription": "Example, turning on the flag",
- "comment": "This is an automated test",
- "subject": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "avatarUrl": "string"
}, - "member": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "507f1f77bcf86cd799439011",
- "email": "ariel@acme.com",
- "firstName": "Ariel",
- "lastName": "Flores"
}, - "token": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "name": "DevOps token",
- "ending": "2345",
- "serviceToken": false
}, - "app": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "isScim": true,
- "name": "string",
- "maintainerName": "string"
}, - "titleVerb": "turned on the flag",
- "title": "string",
- "target": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "Example flag name",
- "resources": [
- "proj/example-project:env/production:flag/example-flag"
]
}, - "parent": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "resource": "string"
}, - "delta": null,
- "triggerBody": null,
- "merge": null,
- "previousVersion": null,
- "currentVersion": null,
- "subentries": [
- {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "1234a56b7c89d012345e678f",
- "_accountId": "1234a56b7c89d012345e678f",
- "date": 0,
- "accesses": [
- {
- "action": "string",
- "resource": "string"
}
], - "kind": "string",
- "name": "Example feature flag",
- "description": "Example, turning on the flag for testing",
- "shortDescription": "Example, turning on the flag",
- "comment": "This is an automated test",
- "subject": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "avatarUrl": "string"
}, - "member": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "507f1f77bcf86cd799439011",
- "email": "ariel@acme.com",
- "firstName": "Ariel",
- "lastName": "Flores"
}, - "token": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "name": "DevOps token",
- "ending": "2345",
- "serviceToken": false
}, - "app": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "_id": "string",
- "isScim": true,
- "name": "string",
- "maintainerName": "string"
}, - "titleVerb": "turned on the flag",
- "title": "string",
- "target": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "Example flag name",
- "resources": [
- "proj/example-project:env/production:flag/example-flag"
]
}, - "parent": {
- "_links": {
- "property1": {
- "href": "string",
- "type": "string"
}, - "property2": {
- "href": "string",
- "type": "string"
}
}, - "name": "string",
- "resource": "string"
}
}
]
}