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

# Leer actividad privada paginada del ticket



## OpenAPI

````yaml /generated/specs/operations.json get /api/v1/tickets/{ticketId}/timeline
openapi: 3.0.0
info:
  title: Raul API - Operaciones
  description: Suscripciones, GPS, actividades, visitas y operacion tecnica.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags: []
paths:
  /api/v1/tickets/{ticketId}/timeline:
    get:
      tags:
        - tickets
      summary: Leer actividad privada paginada del ticket
      operationId: TicketTimelineController_page
      parameters:
        - name: ticketId
          required: true
          in: path
          schema:
            type: string
        - name: scope
          required: false
          in: query
          description: >-
            own (por defecto, compatible con clientes anteriores): sólo el
            ticket; linked: suma la actividad de sus visitas, conversaciones de
            la Bandeja y negocios vinculados (cada fuente exige el módulo de su
            registro)
          schema:
            default: own
            type: string
            enum:
              - own
              - linked
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 50
            default: 30
            allOf:
              - $ref: '#/components/schemas/Object'
        - name: cursor
          required: false
          in: query
          schema:
            type: string
        - name: q
          required: false
          in: query
          schema:
            type: string
        - name: types
          required: false
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
                - note
                - message
                - email
                - call
                - task
                - meeting
                - audit
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TicketTimelinePageDto'
components:
  schemas:
    Object:
      type: object
      properties: {}
    TicketTimelinePageDto:
      type: object
      properties:
        changeCursor:
          type: string
          description: Cursor cifrado capturado en el mismo snapshot que los items
        items:
          type: array
          items:
            $ref: '#/components/schemas/TicketTimelineItemDto'
        nextCursor:
          type: string
          nullable: true
        availableTypes:
          type: array
          items:
            type: string
            enum:
              - note
              - message
              - email
              - call
              - task
              - meeting
              - audit
      required:
        - changeCursor
        - items
        - nextCursor
        - availableTypes
    TicketTimelineItemDto:
      type: object
      properties:
        id:
          type: string
          description: Identidad estable source:uuid
        source:
          type: string
          enum:
            - comment
            - activity
            - task
            - audit
        sourceId:
          type: string
          format: uuid
        type:
          type: string
          enum:
            - note
            - message
            - email
            - call
            - task
            - meeting
            - audit
        visibility:
          type: string
          enum:
            - internal
            - external
            - private
        recordedAt:
          type: string
          format: date-time
        occurredAt:
          type: string
          format: date-time
          nullable: true
        dueAt:
          type: string
          format: date-time
          nullable: true
        authorId:
          type: string
          nullable: true
          format: uuid
        authorName:
          type: string
          nullable: true
        authorAvatarUrl:
          type: string
          nullable: true
        contentPreview:
          type: string
          maxLength: 2000
        contentTruncated:
          type: boolean
        taskStatus:
          type: string
          nullable: true
        editedAt:
          type: string
          format: date-time
          nullable: true
          description: Última edición del registro por su autor
        editable:
          type: boolean
          description: >-
            El actor actual puede editar el texto (autor de una nota interna o
            actividad manual)
        origin:
          description: 'Registro donde ocurrió: el ticket o uno vinculado'
          allOf:
            - $ref: '#/components/schemas/CaseActivityOriginDto'
      required:
        - id
        - source
        - sourceId
        - type
        - visibility
        - recordedAt
        - occurredAt
        - dueAt
        - authorId
        - authorName
        - authorAvatarUrl
        - contentPreview
        - contentTruncated
        - taskStatus
        - editedAt
        - editable
        - origin
    CaseActivityOriginDto:
      type: object
      properties:
        kind:
          type: string
          enum:
            - ticket
            - visit
            - thread
            - opportunity
        id:
          type: string
          description: >-
            Identificador del registro; en una conversación, el id del hilo en
            la Bandeja
        label:
          type: string
          description: 'Etiqueta legible: «Visita del 3-oct», «WhatsApp», título'
        channel:
          type: string
          enum:
            - email
            - whatsapp
          description: Canal de la conversación (sólo kind = thread)
      required:
        - kind
        - id
        - label

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.