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

# Ping a ticket

> Ping a ticket to keep time tracking for agent and to refresh the list of
currently-active agents on this ticket. The FE polls this every 30s and
uses `workedOnBy` to overwrite its cached list, so the "another agent
is working on this ticket" warning becomes two-sided (both the first and
the second agent see it).



## OpenAPI

````yaml https://dev.enneo.dev/api/mind/docs/open-api get /ticket/{ticketId}/ping
openapi: 3.0.0
info:
  version: '1'
  title: enneo.MIND API
  description: This describes the API of enneo Mind, the main ticketing backend
  contact:
    name: enneo GmbH
    email: richard@enneo.ai
  license:
    name: Proprietary software
    url: https://enneo.ai
servers:
  - url: https://demo.enneo.ai/api/mind
    description: Production server, demo client
  - url: https://main.enneo.dev/api/mind
    description: Development main branch
  - url: http://localhost:8005/api/mind
    description: Local development server
security:
  - bearerAuth:
      - api
  - cookieAuth:
      - api
paths:
  /ticket/{ticketId}/ping:
    get:
      tags:
        - Ticket
      summary: Ping a ticket
      description: |-
        Ping a ticket to keep time tracking for agent and to refresh the list of
        currently-active agents on this ticket. The FE polls this every 30s and
        uses `workedOnBy` to overwrite its cached list, so the "another agent
        is working on this ticket" warning becomes two-sided (both the first and
        the second agent see it).
      operationId: pingTicket
      parameters:
        - name: ticketId
          in: path
          required: true
          description: The id of the ticket
          schema:
            type: integer
            example: 376189
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    description: Operation was successful
                  workedOnBy:
                    type: array
                    description: >-
                      Agents currently working on this ticket (live — only
                      entries with

                      `ttl > NOW()` in `ticket_agent`). Includes the pinging
                      user. Same

                      shape as `Ticket.workedOnBy` in `GET /ticket/{id}` — FE
                      overwrites

                      its cached list with this array.
                    items:
                      $ref: '#/components/schemas/AuthProfile'
        '403':
          description: Unauthorized
        '404':
          description: Ticket not found
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AuthProfile:
      type: object
      properties:
        id:
          type: integer
          description: User ID
          example: 1
        firstName:
          type: string
          description: First name
          example: Max
        lastName:
          type: string
          description: Last name
          example: Mustermann
        email:
          type: string
          description: Email address (read only)
          example: demo@enneo.dev
        phone:
          type: string
          description: Phone number
          example: +49 123 456789
        image:
          type: string
          format: base64
          description: Image
          writeOnly: true
          example: >-
            iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=
        password:
          type: string
          description: Password
          writeOnly: true
          example: 123456
        lastSeen:
          type: string
          format: DateTime
          description: The last time the user was seen (read only)
          example: '2022-08-12 12:21:21'
        type:
          type: string
          description: The type of the user
          example: enneo
        isSsoOnly:
          type: integer
          description: >-
            If 1, the user can only login via SSO. If 0, the user can login with
            password or SSO
          enum:
            - 0
            - 1
          example: 0
        lang:
          type: string
          description: The language of the user
          example: de
        nameAlias:
          type: string
          description: Alternative display name or alias for the user
          example: Johnny
        externalId:
          type: string
          description: >-
            External identifier such as employee number or ID from external
            system
          example: EMP-12345
    Error:
      type: object
      description: Data format of Enneo error messages
      properties:
        error:
          type: string
          example: Contract 121 could not be processed
          description: Readable error message that should be shown to the user
        details:
          type: string
          example: >-
            Uncatched null point exception in testFunction() in
            /app/src/file:212
          description: Not easily readable error message that is for the developer
        txId:
          type: string
          example: c916167c94
          description: >-
            Internal transaction id. Useful for debugging. Corresponds to the
            OpenTelemetry trace ID.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-based authentication
      x-scopes:
        api: Full access to the API
    cookieAuth:
      type: apiKey
      in: cookie
      name: connect.sid
      description: Cookie-based authentication
      x-scopes:
        api: Full access to the API

````