openapi: 3.1.0
info:
  version: '1.0'
  title: Zendesk Account Account Settings Ticket Skips API
  description: Needs a description.
tags:
- name: Ticket Skips
paths:
  /api/v2/skips:
    post:
      operationId: RecordNewSkip
      tags:
      - Ticket Skips
      summary: Zendesk Post  Api V2 Skips
      description: 'Record a new ticket skip for the current user.


        #### Allowed For


        * Agents

        '
      responses:
        '201':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TicketSkipCreation'
              examples:
                default:
                  $ref: '#/components/examples/TicketSkipCreationExample'
  /api/v2/users/{user_id}/skips:
    parameters:
    - $ref: '#/components/parameters/SkipTicketUserId'
    - $ref: '#/components/parameters/TicketSortOrder'
    - $ref: '#/components/parameters/TicketId'
    get:
      operationId: ListTicketSkips
      tags:
      - Ticket Skips
      summary: Zendesk Get  Api V2 Users User_id Skips
      description: "Archived tickets are not included in the response. See\n[About archived tickets](https://support.zendesk.com/hc/en-us/articles/203657756) in\nthe Support Help Center.\n\n#### Pagination\n\n- Cursor pagination (recommended)\n- Offset pagination\n\nSee [Pagination](/api-reference/introduction/pagination/).\n\nReturns a maximum of 100 records per page.\n\n#### Allowed For\n* Agents with \"View only\" or higher reports permissions in Support.\n  These permissions are distinct from Explore permissions.\n* Agents retrieving their own skips\n"
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TicketSkipsResponse'
              examples:
                default:
                  $ref: '#/components/examples/TicketSkipResponseExample'
components:
  schemas:
    TicketSkipsResponse:
      type: object
      properties:
        skips:
          type: array
          items:
            $ref: '#/components/schemas/TicketSkipObject'