For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • REST API overview
    • Access Tokens
    • Account Members
    • Account Usage Beta
    • AI Configs
    • Announcements
    • Applications Beta
    • Approvals
    • Approvals Beta
    • Audit Log
      • GETGet audit log entry
      • POSTGet audit log entry counts
      • GETList audit log entries
      • POSTSearch audit log entries
    • Code References
    • Contexts
    • Context Settings
    • Custom Roles
    • Data Export Destinations
    • Environments
    • Experiments
    • Feature Flags
    • Feature Flags Beta
    • Flag Import Configurations Beta
    • Flag Links Beta
    • Flag Triggers
    • Follow Flags
    • Holdouts Beta
    • Insights Charts Beta
    • Insights Deployments Beta
    • Insights Flag Events Beta
    • Insights Pull Requests Beta
    • Insights Repositories Beta
    • Insights Scores Beta
    • Integration Audit Log Subscriptions
    • Integration Delivery Configurations Beta
    • Integrations Beta
    • Layers
    • Metrics
    • Metrics Beta
    • OAuth2 Clients
    • Persistent Store Integrations Beta
    • Projects
    • Relay Proxy Configurations
    • Release Pipelines Beta
    • Releases Beta
    • Scheduled Changes
    • Segments
    • Tags
    • Teams
    • Teams Beta
    • Users
    • Users Beta
    • User Settings
    • Views Beta
    • Webhooks
    • Workflows
    • Workflow Templates
    • Other
Sign inTry it free
LogoLogo
REST API overviewAudit Log

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      "subject": {
23        "_links": {},
24        "name": "string",
25        "avatarUrl": "string"
26      },
27      "member": {
28        "_links": {},
29        "_id": "507f1f77bcf86cd799439011",
30        "email": "ariel@acme.com",
31        "firstName": "Ariel",
32        "lastName": "Flores"
33      },
34      "token": {
35        "_links": {},
36        "_id": "string",
37        "name": "DevOps token",
38        "ending": "2345",
39        "serviceToken": false
40      },
41      "app": {
42        "_links": {},
43        "_id": "string",
44        "isScim": true,
45        "name": "string",
46        "maintainerName": "string"
47      },
48      "titleVerb": "turned on the flag",
49      "title": "string",
50      "target": {},
51      "parent": {
52        "_links": {},
53        "name": "string",
54        "resource": "string"
55      }
56    }
57  ],
58  "_links": {}
59}
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).
Was this page helpful?
Previous

Code References

Next
Built with

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.

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.

Request

This endpoint expects a list of objects.
effectenumRequired
Whether this statement should allow or deny actions on the resources.
Allowed values:
resourceslist of stringsOptional
Resource specifier strings
notResourceslist of stringsOptional

Targeted resources are the resources NOT in this list. The resources field must be empty to use this field.

actionslist of stringsOptional
Actions to perform on a resource
notActionslist of stringsOptional

Targeted actions are the actions NOT in this list. The actions field must be empty to use this field.

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