Search audit log entries

POST

/api/v2/auditlog

POST

/api/v2/auditlog

$ curl -X POST https://app.launchdarkly.com/api/v2/auditlog \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '[
>   {
>     "effect": "allow"
>   }
> ]'

1 {
2   "items": [
3     {
4       "_links": {},
5       "_id": "1234a56b7c89d012345e678f",
6       "_accountId": "1234a56b7c89d012345e678f",
7       "date": 1654104600000,
8       "accesses": [
9         {
10           "action": "string",
11           "resource": "string"
12         }
13       ],
14       "kind": "flag",
15       "name": "Example feature flag",
16       "description": "Example, turning on the flag for testing",
17       "shortDescription": "Example, turning on the flag",
18       "comment": "This is an automated test",
19       "relatedFlag": {
20         "key": "string"
21       },
22       "relatedExperiment": {
23         "key": "string"
24       },
25       "relatedAIConfig": {
26         "key": "string"
27       },
28       "subject": {
29         "_links": {},
30         "name": "string",
31         "avatarUrl": "string"
32       },
33       "member": {
34         "_links": {},
35         "_id": "507f1f77bcf86cd799439011",
36         "email": "ariel@acme.com",
37         "firstName": "Ariel",
38         "lastName": "Flores"
39       },
40       "token": {
41         "_links": {},
42         "_id": "string",
43         "name": "DevOps token",
44         "ending": "2345",
45         "serviceToken": false
46       },
47       "app": {
48         "_links": {},
49         "_id": "string",
50         "isScim": true,
51         "name": "string",
52         "maintainerName": "string"
53       },
54       "titleVerb": "turned on the flag",
55       "title": "string",
56       "target": {},
57       "parent": {
58         "_links": {},
59         "name": "string",
60         "resource": "string"
61       }
62     }
63   ],
64   "_links": {}
65 }

LaunchDarkly uses a resource specifier syntax to name resources or collections of resources. To learn more, read About the resource specifier syntax.

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](https://launchdarkly.com/docs/home/account/role-resources#about-the-resource-specifier-syntax).

Authentication

Authorizationstring

API Key authentication via header

Query parameters

beforelongOptional

A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred before the timestamp.

afterlongOptional

A timestamp filter, expressed as a Unix epoch time in milliseconds. All entries returned occurred after the timestamp.

qstringOptionalformat: "string"

Text to search for. You can search for the full or partial name of the resource.

limitlongOptional

A limit on the number of audit log entries that return. Set between 1 and 20. The default is 10.

memberstringOptionalformat: "string"

A member ID that lets you filter audit log listings by the member who made the change. Repeat the parameter to filter by multiple members.

tokenstringOptionalformat: "string"

An access token ID that lets you filter audit log listings by the token that made the change. Repeat the parameter to filter by multiple tokens.

Request

This endpoint expects a list of objects.

Response

Audit log entries response

itemslist of objects

An array of audit log entries

_linksmap from strings to objects

The location and content type of related resources

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error