> ## 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 cambios autorizados de actividad desde un cursor de commit



## OpenAPI

````yaml /generated/specs/operations.json get /api/v1/tickets/{ticketId}/timeline/changes
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/changes:
    get:
      tags:
        - tickets
      summary: Leer cambios autorizados de actividad desde un cursor de commit
      operationId: TicketTimelineChangesController_changes
      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: 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
        - name: after
          required: true
          in: query
          description: Cursor cifrado de cambios ligado a la página y filtros
          schema:
            minLength: 379
            maxLength: 379
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TicketTimelineChangesResponseDto'
components:
  schemas:
    TicketTimelineChangesResponseDto:
      type: object
      properties:
        upserts:
          type: array
          items:
            $ref: '#/components/schemas/TicketTimelineItemDto'
        nextChangeCursor:
          type: string
        hasMore:
          type: boolean
        resetRequired:
          type: boolean
          description: >-
            Limpiar sólo la timeline y recargar su primera página autorizada;
            conservar editor y borradores
      required:
        - upserts
        - nextChangeCursor
        - hasMore
        - resetRequired
    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.