> ## 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. # Delete operator shortcut > Soft-deletes a shortcut. Any files attached to it are deliberately left in storage: messages already dispatched from this shortcut reference the very same objects, so removing them would break chat history. ## OpenAPI ````yaml /api/services-api.yaml delete /v1/tenants/{tenantID}/operators/shortcuts/{shortcutID} 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.65.0 servers: - description: Production url: https://services-api.talqui.chat security: [] tags: - name: Tenants - name: Settings - name: Analytics - name: Campaigns - name: Campaigns models - name: Contacts - name: Handoff links - name: Inboxes - name: Messages - name: Notifications - name: Sessions - name: Operators - name: Plugins - name: Setup - name: Uploads paths: /v1/tenants/{tenantID}/operators/shortcuts/{shortcutID}: delete: tags: - Operators summary: Delete operator shortcut description: >- Soft-deletes a shortcut. Any files attached to it are deliberately left in storage: messages already dispatched from this shortcut reference the very same objects, so removing them would break chat history. operationId: DeleteOperatorShortcutController parameters: - in: path name: tenantID required: true schema: description: The tenant the shortcut belongs to. 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: shortcutID required: true schema: description: The shortcut being deleted. 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 responses: '200': content: application/json: schema: {} description: Response for status 200. '400': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/MissingTenantIDError' - $ref: '#/components/schemas/MissingShortcutIDError' - $ref: '#/components/schemas/RequestValidationError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- MissingTenantIDError (error_code 1001): tenantID absent from the URL. | MissingShortcutIDError (error_code 1400): shortcutID absent from the URL. | RequestValidationError (error_code 1002): params fail schema validation. '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.' '403': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/ForbiddenError' - $ref: '#/components/schemas/ShortcutScopeForbiddenError' - $ref: '#/components/schemas/ShortcutOwnershipError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- ForbiddenError (error_code 1004): operator token rejected upstream, or operator does not belong to the tenant. | ShortcutScopeForbiddenError (error_code 1403): company-wide shortcut and the operator is not a manager or above. | ShortcutOwnershipError (error_code 1404): the shortcut is personal and belongs to another operator. '404': content: application/json: schema: properties: errors: items: oneOf: - $ref: '#/components/schemas/TenantNotFoundError' - $ref: '#/components/schemas/ShortcutNotFoundError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- TenantNotFoundError (error_code 1062): tenantID does not resolve to a tenant. | ShortcutNotFoundError (error_code 1401): shortcutID does not resolve to a live shortcut on this tenant. '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. security: - operatorAuth: [] components: schemas: MissingTenantIDError: additionalProperties: false properties: error: enum: - MissingTenantIDError type: string error_code: enum: - 1001 type: number message: example: tenantID is required. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message type: object MissingShortcutIDError: additionalProperties: false properties: error: enum: - MissingShortcutIDError type: string error_code: enum: - 1400 type: number message: example: shortcutID is required for this operation. 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 ForbiddenError: additionalProperties: false properties: error: enum: - ForbiddenError type: string error_code: enum: - 1004 type: number message: example: You do not have access to this resource. type: string statusCode: enum: - 403 type: number required: - statusCode - error - error_code - message type: object ShortcutScopeForbiddenError: additionalProperties: false properties: error: enum: - ShortcutScopeForbiddenError type: string error_code: enum: - 1403 type: number message: example: Your role does not allow managing shortcuts on this scope. type: string statusCode: enum: - 403 type: number required: - statusCode - error - error_code - message type: object ShortcutOwnershipError: additionalProperties: false properties: error: enum: - ShortcutOwnershipError type: string error_code: enum: - 1404 type: number message: example: This shortcut belongs to another operator. type: string statusCode: enum: - 403 type: number required: - statusCode - error - error_code - message type: object TenantNotFoundError: additionalProperties: false properties: error: enum: - TenantNotFoundError type: string error_code: enum: - 1062 type: number message: example: Tenant not found. type: string statusCode: enum: - 404 type: number required: - statusCode - error - error_code - message type: object ShortcutNotFoundError: additionalProperties: false properties: error: enum: - ShortcutNotFoundError type: string error_code: enum: - 1401 type: number message: example: Shortcut not found. type: string statusCode: enum: - 404 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 securitySchemes: operatorAuth: bearerFormat: JWT description: >- Behalf of an Operator (default). A JWT issued by Talqui Core when an operator signs in, scoped to every tenant that operator belongs to. Send as `Authorization: Bearer `. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.