Get announcements | LaunchDarkly

curl -G https://app.launchdarkly.com/api/v2/announcements \
     -H "Authorization: <apiKey>" \
     -d status=active

{
  "items": [
    {
      "_id": "1234567890",
      "isDismissible": true,
      "title": "System Maintenance Notice",
      "message": "**Important Update:**\n\nPlease be aware of the upcoming maintenance scheduled for *October 31st, 2024*. The system will be unavailable from **12:00 AM** to **4:00 AM**.",
      "startTime": 1731439812,
      "severity": "info",
      "_status": "active",
      "_links": {
        "parent": {
          "href": "href",
          "type": "type"
        }
      },
      "endTime": 1731439880,
      "_access": {
        "allowed": [
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          },
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          }
        ],
        "denied": [
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          },
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          }
        ]
      }
    },
    {
      "_id": "1234567890",
      "isDismissible": true,
      "title": "System Maintenance Notice",
      "message": "**Important Update:**\n\nPlease be aware of the upcoming maintenance scheduled for *October 31st, 2024*. The system will be unavailable from **12:00 AM** to **4:00 AM**.",
      "startTime": 1731439812,
      "severity": "info",
      "_status": "active",
      "_links": {
        "parent": {
          "href": "href",
          "type": "type"
        }
      },
      "endTime": 1731439880,
      "_access": {
        "allowed": [
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          },
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          }
        ],
        "denied": [
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          },
          {
            "action": "action",
            "reason": {
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "actions": [
                "*"
              ],
              "notActions": [
                "string",
                "string"
              ],
              "role_name": "role_name"
            }
          }
        ]
      }
    }
  ],
  "_links": {
    "self": {
      "href": "href",
      "type": "type"
    },
    "first": {
      "href": "href",
      "type": "type"
    },
    "last": {
      "href": "href",
      "type": "type"
    },
    "next": {
      "href": "href",
      "type": "type"
    },
    "prev": {
      "href": "href",
      "type": "type"
    }
  }
}

Get announcements

Authentication

Authorizationstring

API Key authentication via header

Query parameters

statusenumOptional

Filter announcements by status.

Allowed values:

limitintegerOptional

The number of announcements to return.

offsetintegerOptional

Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query limit.

Response

Announcement response

itemslist of objects

_linksobject

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error