---
title: "Get Log Drop Filter"
method: POST
path: "/log-drop-filter/{id}/get-item"
tags: ["Log Drop Filter"]
---

# Get Log Drop Filter

`POST /log-drop-filter/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/log-drop-filter/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/log-drop-filter/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single Log Drop Filter by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `select` LogDropFilterSelectSchema: Select schema for LogDropFilter. Set fields to true to include them in the response.
    - `_id` boolean
    - `createdAt` boolean
    - `updatedAt` boolean
    - `deletedAt` boolean
    - `projectId` boolean
    - `name` boolean
    - `description` boolean
    - `filterQuery` boolean
    - `action` boolean
    - `samplePercentage` boolean
    - `isEnabled` boolean
    - `sortOrder` boolean
    - `droppedCount` boolean
    - `lastDroppedAt` boolean
    - `createdByUserId` boolean
    - `deletedByUserId` boolean

## Response `200`

Successful response

- object
  - `data` LogDropFilter
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `version` number: Object version
    - `projectId` string, uuid, required: ID of the project this log drop filter belongs to. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [No access - you don't have permission for this operation]
    - `name` string, required: Friendly name for this drop filter. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `description` string: Description of what this drop filter does. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `filterQuery` string, required: Filter expression that identifies which logs to drop or sample. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `action` 'drop' | 'sample', required: What to do with matching logs: 'drop' to discard entirely, 'sample' to keep a percentage. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `samplePercentage` number: When action is 'sample', the percentage of matching logs to keep (1-99). Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `isEnabled` boolean, required: Whether this drop filter is active. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `sortOrder` number: Where this filter is evaluated among the project's log drop filters, lowest number first. A new filter is added to the end of the list. Setting a number another one already has puts it in that place, and the ones in the way move one place along to make room. In the dashboard, drag the rows to reorder them. Permissions - Create: [Project Owner, Project Admin, Create Log Drop Filter], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [Project Owner, Project Admin, Edit Log Drop Filter]
    - `droppedCount` number: Total number of logs this filter has discarded since it was created. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [No access - you don't have permission for this operation]
    - `lastDroppedAt` object: When this filter most recently discarded a log. Null means it has never matched anything. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [No access - you don't have permission for this operation]
    - `createdByUserId` string, uuid: ID of the user who created this log drop filter. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [No access - you don't have permission for this operation]
    - `deletedByUserId` string, uuid: ID of the user who deleted this log drop filter. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Telemetry Admin, Telemetry Member, Telemetry Viewer, Read Log Drop Filter], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)