> ## Documentation Index > Fetch the complete documentation index at: https://docs.slate-labs.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Transaction Comment > Write or edit the operator comment on a transaction. Low-risk annotation — no money moves. Gated at role level >= 30. Empty string clears the comment to NULL. ## OpenAPI ````yaml /openapi.json patch /transactions/{tx_id}/comment openapi: 3.1.0 info: title: Slate API version: 1.0.0 description: Trading infrastructure API. servers: - url: https://api.{your-broker}.slate-labs.com variables: your-broker: default: broker security: [] tags: - name: Authentication - name: API Tokens - name: Customers - name: Accounts - name: Orders - name: Instruments & Groups - name: Transactions - name: Payments - name: Transfers - name: Risk - name: Workflow & CRM - name: Messaging - name: Integrations - name: Webhooks - name: Compliance - name: Promo codes - name: Reporting - name: Audit - name: Fraud & moderation - name: Broker settings - name: Users - name: Roles & Teams - name: Streams (SSE) - name: Simulator - name: Observability - name: Prop trading paths: /transactions/{tx_id}/comment: patch: tags: - Transactions summary: Update Transaction Comment description: |- Write or edit the operator comment on a transaction. Low-risk annotation — no money moves. Gated at role level >= 30. Empty string clears the comment to NULL. operationId: update_transaction_comment_transactions__tx_id__comment_patch parameters: - name: tx_id in: path required: true schema: type: string format: uuid title: Tx Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TransactionCommentRequest' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TransactionResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - bearerAuth: [] components: schemas: TransactionCommentRequest: properties: comment: anyOf: - type: string maxLength: 2000 - type: 'null' title: Comment type: object title: TransactionCommentRequest description: Write/edit the comment on a transaction. Empty string clears it. TransactionResponse: properties: id: type: string format: uuid title: Id source: type: string title: Source cashier_id: anyOf: - type: string - type: 'null' title: Cashier Id order_id: anyOf: - type: string - type: 'null' title: Order Id customer_id: type: string format: uuid title: Customer Id account_id: type: string format: uuid title: Account Id manager_id: anyOf: - type: string format: uuid - type: 'null' title: Manager Id approved_by: anyOf: - type: string format: uuid - type: 'null' title: Approved By transaction_owner: anyOf: - type: string format: uuid - type: 'null' title: Transaction Owner team_id: anyOf: - type: string format: uuid - type: 'null' title: Team Id gate_id: anyOf: - type: string - type: 'null' title: Gate Id gate_name: anyOf: - type: string - type: 'null' title: Gate Name payment_data: anyOf: - type: object - type: 'null' title: Payment Data amount: type: string title: Amount currency: type: string title: Currency account_amount: type: string title: Account Amount usd_amount: anyOf: - type: string - type: 'null' title: Usd Amount exchange_rate_usd: anyOf: - type: string - type: 'null' title: Exchange Rate Usd proof_reference: anyOf: - type: string - type: 'null' title: Proof Reference proof_url: anyOf: - type: string - type: 'null' title: Proof Url type: type: string title: Type status: type: string title: Status customer_view: type: boolean title: Customer View comment: anyOf: - type: string - type: 'null' title: Comment create_time: type: string format: date-time title: Create Time update_time: type: string format: date-time title: Update Time approve_time: anyOf: - type: string format: date-time - type: 'null' title: Approve Time decline_time: anyOf: - type: string format: date-time - type: 'null' title: Decline Time account_currency: anyOf: - type: string - type: 'null' title: Account Currency fx_rate_applied: anyOf: - type: string - type: 'null' title: Fx Rate Applied related_transaction_id: anyOf: - type: string format: uuid - type: 'null' title: Related Transaction Id account_login: anyOf: - type: string - type: 'null' title: Account Login manager_name: anyOf: - type: string - type: 'null' title: Manager Name approved_by_name: anyOf: - type: string - type: 'null' title: Approved By Name transaction_owner_name: anyOf: - type: string - type: 'null' title: Transaction Owner Name chargeback_of: anyOf: - type: string format: uuid - type: 'null' title: Chargeback Of payout_provider: anyOf: - type: string - type: 'null' title: Payout Provider payout_status: anyOf: - type: string - type: 'null' title: Payout Status payout_reference: anyOf: - type: string - type: 'null' title: Payout Reference payout_attempt: anyOf: - type: integer - type: 'null' title: Payout Attempt payout_submitted_at: anyOf: - type: string format: date-time - type: 'null' title: Payout Submitted At payout_completed_at: anyOf: - type: string format: date-time - type: 'null' title: Payout Completed At payout_failure_reason: anyOf: - type: string - type: 'null' title: Payout Failure Reason type: object required: - id - source - cashier_id - order_id - customer_id - account_id - manager_id - approved_by - transaction_owner - team_id - gate_id - gate_name - payment_data - amount - currency - account_amount - usd_amount - exchange_rate_usd - proof_reference - proof_url - type - status - customer_view - comment - create_time - update_time - approve_time - decline_time title: TransactionResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````