Skip to main content
GET
/
v1
/
announcements
curl https://api.truthlocks.com/v1/announcements \
  -H "X-API-Key: tlk_your_key_here"

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "source_platform": "Truthlock Platform",
      "subject": "Scheduled maintenance window",
      "body": "We will perform scheduled maintenance on April 20 from 02:00 to 04:00 UTC. No downtime is expected.",
      "priority": "NORMAL",
      "is_read": false,
      "created_at": "2026-04-14T10:00:00Z",
      "updated_at": "2026-04-14T10:00:00Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "source_platform": "Truthlock Platform",
      "subject": "New signing key algorithm support",
      "body": "Ed25519 keys are now the default for all new issuers.",
      "priority": "NORMAL",
      "is_read": true,
      "external_link": "https://docs.truthlocks.com/changelog",
      "created_at": "2026-04-10T08:00:00Z",
      "updated_at": "2026-04-10T09:15:00Z"
    }
  ]
}
Returns all announcements sent to your tenant by the Truthlocks platform. Announcements include system updates, security alerts, and operational notifications. You can also view announcements in the console. See the console onboarding guide for details on the announcements inbox.

​
Responses

{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "source_platform": "Truthlock Platform",
      "subject": "Scheduled maintenance window",
      "body": "We will perform scheduled maintenance on April 20 from 02:00 to 04:00 UTC. No downtime is expected.",
      "priority": "NORMAL",
      "is_read": false,
      "created_at": "2026-04-14T10:00:00Z",
      "updated_at": "2026-04-14T10:00:00Z"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440000",
      "tenant_id": "440e8400-e29b-41d4-a716-446655440000",
      "source_platform": "Truthlock Platform",
      "subject": "New signing key algorithm support",
      "body": "Ed25519 keys are now the default for all new issuers.",
      "priority": "NORMAL",
      "is_read": true,
      "external_link": "https://docs.truthlocks.com/changelog",
      "created_at": "2026-04-10T08:00:00Z",
      "updated_at": "2026-04-10T09:15:00Z"
    }
  ]
}

curl https://api.truthlocks.com/v1/announcements \
  -H "X-API-Key: tlk_your_key_here"

​
Announcement priority levels

PriorityDescription
NORMALGeneral platform updates and informational messages.
URGENTTime-sensitive changes that may affect your workflows.
CRITICALSecurity alerts or service disruptions requiring immediate attention.