> ## Documentation Index > Fetch the complete documentation index at: https://docs.talqui.chat/llms.txt > Use this file to discover all available pages before exploring further. # Notify a milestone > Records that the authenticated operator reached the milestone named by `milestoneKey` (a product tour seen, a feature tried), so the app never offers it again, on any device or tenant: the milestone belongs to the operator, the tenant only scopes the call. Idempotent: a key already reached answers its first record with `created: false`. ## OpenAPI ````yaml /api/services-api.yaml put /v1/tenants/{tenantID}/milestones/{milestoneKey} openapi: 3.0.3 info: description: >- Talqui is an omnichannel customer service platform that unifies conversations from WhatsApp, Instagram, Telegram, and many other channels into a single attendant panel, alongside a broader ecosystem of plugins and integrations. This API gives developers programmatic access to Talqui's services layer, exposing the operations needed to read and manage tenants, conversations, plugins, and related resources that power that platform. Authentication is available on behalf of an Operator (the default for this API), a Plugin Connection, or a Plugin — see the [Talqui authentication guide](https://docs.talqui.chat/guides/introduction/authentication/) for how each token is obtained and when to use it. Need help or have questions not covered here? Reach out to support@talqui.com. license: name: ISC url: https://opensource.org/license/isc-license-txt title: Talqui - Services API version: 0.95.1 servers: - description: Production url: https://services-api.talqui.chat security: [] tags: - name: Tenants - name: Settings - name: Analytics/Reports - name: Analytics - name: Campaigns - name: Campaigns/Models - name: Contacts - name: Contacts/Imports - name: Handoff links - name: Inboxes - name: Messages - name: Notifications - name: Sessions - name: Operators/Shortcuts - name: Operators - name: Plugins - name: Milestones paths: /v1/tenants/{tenantID}/milestones/{milestoneKey}: put: tags: - Milestones summary: Notify a milestone description: |- Records that the authenticated operator reached the milestone named by `milestoneKey` (a product tour seen, a feature tried), so the app never offers it again, on any device or tenant: the milestone belongs to the operator, the tenant only scopes the call. Idempotent: a key already reached answers its first record with `created: false`. operationId: NotifyMilestoneController parameters: - in: path name: tenantID required: true schema: description: The tenant the operator works in. format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ type: string - in: path name: milestoneKey required: true schema: description: >- The milestone name: lowercase words joined by ".", ":", "_" or "-" (e.g. "tour:inbox-2026-10"). maxLength: 100 minLength: 3 pattern: ^[a-z0-9]+(?:[.:_-][a-z0-9]+)*$ type: string responses: '200': content: application/json: schema: additionalProperties: false properties: data: additionalProperties: false properties: created: description: >- False when the operator had already reached it (nothing changed). type: boolean milestone: additionalProperties: false properties: createdAt: description: When the operator first reached it. format: date-time type: string milestoneKey: description: The milestone name. type: string required: - milestoneKey - createdAt type: object required: - milestone - created type: object required: - data type: object description: Response for status 200. '400': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/MissingOperatorIDError' - $ref: '#/components/schemas/RequestValidationError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- MissingOperatorIDError (error_code 1063): the resolved identity carries no operatorID. | RequestValidationError (error_code 1002): the key is not lowercase words joined by ".", ":", "_" or "-". '401': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/UnauthorizedError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: 'UnauthorizedError (error_code 1003): missing/invalid operator token.' '500': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/UnknownError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- UnknownError (error_code 5999): Unexpected internal error not otherwise documented for this endpoint. components: schemas: MissingOperatorIDError: additionalProperties: false properties: error: enum: - MissingOperatorIDError type: string error_code: enum: - 1063 type: number message: example: operatorID is required. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message type: object RequestValidationError: additionalProperties: false properties: error: enum: - RequestValidationError type: string error_code: enum: - 1002 type: number fields: items: additionalProperties: false properties: allowed: type: string field: type: string received: type: string required: - field - received - allowed type: object type: array message: example: Invalid request data. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message - fields type: object UnauthorizedError: additionalProperties: false properties: error: enum: - UnauthorizedError type: string error_code: enum: - 1003 type: number message: example: You are not authorized to perform this request. type: string statusCode: enum: - 401 type: number required: - statusCode - error - error_code - message type: object UnknownError: additionalProperties: false properties: error: enum: - UnknownError type: string error_code: enum: - 5999 type: number message: example: For some unknown reason your request has not succeeded. type: string statusCode: enum: - 500 type: number required: - statusCode - error - error_code - message type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.