> ## Documentation Index
> Fetch the complete documentation index at: https://developers.initdesk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve custom preset filter

> Return a saved ticket search filter by ID. Integration tokens may only retrieve organization-shared filters.



## OpenAPI

````yaml https://api.initdesk.com/schema.yaml get /organizations/{organization_id}/custom-preset-filters/{id}/
openapi: 3.0.3
info:
  title: initdesk Customer API
  version: 1.30.0
  description: OpenAPI documentation for the customer-facing API served by the gateway.
servers:
  - url: https://api.initdesk.com
    description: Customer API gateway
security:
  - IntegrationToken: []
tags:
  - name: Organizations
    description: Organization metadata and context for all other resources.
  - name: Customers
    description: >-
      End users (requesters) scoped to the organization. Tickets reference
      customers by ID.
  - name: Tickets
    description: >-
      Tickets, messages, attachments, search, and statuses. A ticket is the
      conversation container; messages are nested under
      `/tickets/{pk}/messages/`.
  - name: Custom Preset Filters
    description: >-
      Saved ticket search filters scoped to the organization. Integration tokens
      receive organization-shared filters only.
  - name: Inboxes
    description: >-
      Organization mailboxes for routing tickets. Each inbox has an email prefix
      and optional default-inbox flag (is_default: true). On ticket create,
      inbox_id is optional: omit to use the default inbox, or provide an inbox
      ID to target a specific mailbox.
  - name: Tags
    description: Organization-scoped ticket tags with id, name, and optional color.
  - name: Help Center
    description: >-
      Support portal settings, knowledge base collections, articles, and article
      search.
paths:
  /organizations/{organization_id}/custom-preset-filters/{id}/:
    get:
      tags:
        - Custom Preset Filters
      summary: Retrieve custom preset filter
      description: >-
        Return a saved ticket search filter by ID. Integration tokens may only
        retrieve organization-shared filters.
      operationId: retrieve_custom_preset_filter
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
        - in: path
          name: organization_id
          schema:
            type: string
            pattern: ^[-a-zA-Z0-9_]+$
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomPresetFilter'
          description: ''
      security:
        - IntegrationToken: []
components:
  schemas:
    CustomPresetFilter:
      type: object
      description: >-
        Serializer for creating and updating custom preset filters.


        Seeded defaults may carry an internal ``key`` (never exposed here). When

        ``key`` is set, ``name`` in the response is translated via gettext for
        the

        request locale. Providing ``name`` on update clears ``key`` so the
        stored

        name becomes user-owned data (translate-until-renamed).
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type: string
          maxLength: 255
        position:
          type: integer
          maximum: 2147483647
          minimum: 0
          description: >-
            Display order within the visibility band (lower first). Personal and
            organization-shared filters are ordered in separate bands.
        display_count:
          type: boolean
          description: Whether the inbox UI should show a ticket count for this filter.
        visibility:
          enum:
            - personal
            - organization_shared
          type: string
          description: |-
            * `personal` - Personal
            * `organization_shared` - Organization shared
          x-spec-enum-id: 728c506dc785294d
        criteria:
          $ref: '#/components/schemas/CustomPresetFilterCriteria'
        created_by:
          allOf:
            - $ref: '#/components/schemas/CustomPresetFilterCreatedBy'
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - created_at
        - created_by
        - criteria
        - id
        - name
        - updated_at
    CustomPresetFilterCriteria:
      type: object
      description: Structured ticket search criteria for custom preset filters.
      properties:
        tags_include:
          type: array
          items:
            type: string
        tags_exclude:
          type: array
          items:
            type: string
        assignee_ids:
          type: array
          items:
            oneOf:
              - type: integer
              - type: string
                enum:
                  - me
                  - unassigned
        statuses:
          type: array
          items:
            enum:
              - created
              - active
              - closed
            type: string
            description: |-
              * `created` - Created
              * `active` - Active
              * `closed` - Closed
            x-spec-enum-id: 786352f031cd9dcc
        waiting_on:
          type: array
          items:
            enum:
              - ''
              - customer
              - associate
            type: string
            description: |-
              * `` - (none)
              * `customer` - Customer
              * `associate` - Associate
            x-spec-enum-id: 1b01ac3e125d3656
        inbox_ids:
          type: array
          items:
            type: integer
        channels:
          type: array
          items:
            enum:
              - email
              - telegram
              - whatsapp
            type: string
            description: |-
              * `email` - Email
              * `telegram` - Telegram
              * `whatsapp` - WhatsApp
            x-spec-enum-id: f922a1c503c36380
        classifications:
          type: array
          items:
            enum:
              - ''
              - no_response
              - customer_inactivity
              - resolved
              - invalid
              - other
            type: string
            description: |-
              * `` - (pending)
              * `no_response` - No Response
              * `customer_inactivity` - Customer Inactivity
              * `resolved` - Resolved
              * `invalid` - Invalid
              * `other` - Other
            x-spec-enum-id: 4fafa904badf8649
        is_snoozed:
          type: boolean
    CustomPresetFilterCreatedBy:
      type: object
      description: Read-only creator summary for custom preset filter responses.
      properties:
        id:
          type: integer
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
          title: Email address
        name:
          type: string
          readOnly: true
          title: Name of User
      required:
        - email
        - id
        - name
  securitySchemes:
    IntegrationToken:
      type: apiKey
      in: header
      name: X-Initdesk-Token

````