# Anypoint Platform Audit Log API

Query audit log events, actions, and object types for organizations on the Anypoint Platform. Configure log retention settings.

- **Version:** 2.0.0
- **Category:** Governance
- **OpenAPI Spec:** [api.yaml](https://dev-portal.mulesoft.com/apis/audit-log-query/api.yaml)

## Servers
- `https://anypoint.mulesoft.com/audit/{version}`
- `https://{region}.anypoint.mulesoft.com/audit/{version}`
- `https://{region}.platform.mulesoft.com/audit/{version}`

## Operations (7)
### POST /organizations/{id}/query{mediaTypeExtension}

**Operation ID:** `createOrganizationsByIdQueryMediatypeextension`
Searches for log entries. Query parameters are documented in the logQuery schema.
Entries returned will match the entries that were passed in, and are sorted in
ascending timestamp order (oldest to newest).


**Parameters:**
| `cursorPagination` | query | Use cursor based pagination | optional |
| `doIncludeTotal` | query | Include total value in the response | optional |
| `getVersionedObjectsInLogs` | query | Get versioned object from the time of log creation, instead of latest object. 
Logs for objects created or updated on or after November 29, 2023 will return versioned object information;
Other logs will show no change in behavior.
 | optional |
| `id` | query | The id to identify the target resource. | required |
| `mediaTypeExtension` | query | The mediaTypeExtension to identify the target resource. | required |

### GET /organizations/{id}/platforms

**Operation ID:** `getOrganizationsByIdPlatforms`
Gets all platforms of an organization


**Parameters:**
| `id` | query | The id to identify the target resource. | required |

### GET /organizations/{id}/objectTypes

**Operation ID:** `getOrganizationsByIdObjecttypes`
Gets all objectTypes of an organization


**Parameters:**
| `id` | query | The id to identify the target resource. | required |

### GET /organizations/{id}/objects

**Operation ID:** `getOrganizationsByIdObjects`
Query objects by objectTypes, platforms and search text passed as parameters
  example: |
    /organizations/{id}/objects?objectType=XX&object_type=YY&search=test-application
    /organizations/{id}/objects?platform=A-111&platform=B-222&search=test-application
    /organizations/{id}/objects?platform=A-111&platform=B-222&object_type=YY


**Parameters:**
| `offset` | query | Pagination parameter to start returning object from this position of matches | required |
| `objectType` | query | Object type name, supports multiple object types | required |
| `objectId` | query | Object Id, supports multiple object ids | required |
| `platform` | query | Platform name, supports multiple platforms | required |
| `limit` | query | Limits the number of objects returned | required |
| `search` | query | The string to search for in object names | required |
| `id` | query | The id to identify the target resource. | required |

### GET /organizations/{id}/actions

**Operation ID:** `getOrganizationsByIdActions`
Gets all actions and object types associated with them.


**Parameters:**
| `id` | query | The id to identify the target resource. | required |

### GET /organizations/{id}/retentionSettings

**Operation ID:** `getOrganizationsByIdRetentionsettings`
Gets retention setting entries for an organization including the current retention period.


**Parameters:**
| `id` | query | The id to identify the target resource. | required |

### PUT /organizations/{id}/retentionSettings

**Operation ID:** `updateOrganizationsByIdRetentionsettings`
Sets retention setting for an organization. The organization id should be a root organization id as retention period can not be set for a sub-organization.


**Parameters:**
| `id` | query | The id to identify the target resource. | required |