---
title: "Retrieve logs"
method: GET
path: "/cms/audit-logs/2026-09"
tags: ["Basic"]
---

# Retrieve logs

`GET /cms/audit-logs/2026-09`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/audit-logs/2026-09`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

Retrieve audit logs for the CMS in your HubSpot account. This endpoint allows you to filter logs by user, event type, object type, and object ID. It supports pagination and sorting, making it easier to navigate through large sets of log data. Use this endpoint to monitor changes and activities within your CMS.

## Query parameters

- `after` string
- `before` string
- `eventType` string[]
- `limit` integer
- `objectId` string[]
- `objectType` string[]
- `sort` string[]
- `userId` string[]

## Response `200`

successful operation

- CollectionResponsePublicAuditLog
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: Cursor token representing the boundary timestamp after which to fetch the next page of results. Pass this value as the after query parameter to retrieve later audit logs.
      - `link` string: Pre-constructed URL that can be used to directly fetch the next page of results without manually building the query.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: Pre-constructed URL that can be used to directly fetch the previous page of results without manually building the query.
      - `link` string: Cursor token representing the boundary timestamp before which to fetch the previous page of results. Pass this value as the before query parameter to retrieve earlier audit logs.
  - `results` PublicAuditLog[], required: An array of PublicAuditLog objects, each representing a single audit log entry.
    - `event` 'CREATED' | 'DELETED' | 'PUBLISHED' | 'RESTORE' | 'UNPUBLISHED' | 'UPDATED', required: The type of event that took place (CREATED, UPDATED, PUBLISHED, DELETED, UNPUBLISHED).
    - `fullName` string, required: The name of the user who caused the event.
    - `meta` object, required: Supplementary metadata associated with the audit log entry. It provides additional context about the audited event (ex: rows deleted/updated for a HubDB event, the specific fields that were changed for a Content Settings event).
    - `objectId` string, required: The ID of the object.
    - `objectName` string, required: The internal name of the object in HubSpot.
    - `objectType` 'BLOG' | 'BLOG_POST' | 'CASE_STUDY' | 'CONTENT_SETTINGS' | 'CSS' | 'CTA' | 'DOMAIN' | 'EMAIL' | 'FILE' | 'GLOBAL_MODULE' | 'HUBDB_TABLE' | 'JS' | 'KNOWLEDGE_BASE' | 'KNOWLEDGE_BASE_ARTICLE' | 'LANDING_PAGE' | 'MODULE' | 'PODCAST' | 'QUOTE' | 'SERVERLESS_FUNCTION' | 'TEMPLATE' | 'THEME' | 'URL_MAPPING' | 'WEB_INTERACTIVE' | 'WEBSITE_PAGE', required: The type of the object (BLOG, LANDING_PAGE, DOMAIN, HUBDB_TABLE etc.)
    - `timestamp` string, date-time, required: The timestamp at which the event occurred.
    - `userId` string, required: The ID of the user who caused the event.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-09-03** (2026-09) `7c5eb500123c`: 2 info
  - api operation id `get-/cms/audit-logs/2026-09_/cms/audit-logs/2026-09` removed and replaced with `get-/cms/audit-logs/2026-09_/cms/audit-logs/v3`
  - the endpoint scheme security `private_apps` was removed from the API

[Operation history](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/changes/cms/audit-logs/2026-09/get.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-cms-content-audit.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-cms-content-audit/revisions/8f47ddb9b035?raw)