> ## Documentation Index > Fetch the complete documentation index at: https://docs.tied.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a message > Update a message ## OpenAPI ````yaml /api-reference/openapi.json patch /public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations/{conversation_id}/messages/{message_id} openapi: 3.0.4 info: title: Tied API description: >- The Tied REST API. Three families of endpoint, each with its own credential: **Application** for everything inside an account, **Platform** for provisioning accounts and users, and **Client** for acting as a contact from your own surface. version: 1.1.0 termsOfService: https://tied.com/legal contact: email: hello@tied.com license: name: MIT License url: https://opensource.org/licenses/MIT servers: - url: https://app.tied.com description: Tied cloud security: [] tags: - name: Account AgentBots description: Account-specific Agent Bots - name: Agents description: Agent management APIs - name: Canned Responses description: Pre-defined responses for common queries - name: Contacts description: Contact management APIs - name: Contact Labels description: Manage contact labels - name: Conversation Assignments description: Manage conversation assignments - name: Conversation Labels description: Manage conversation labels - name: Conversations description: Conversation management APIs - name: Custom Attributes description: Custom fields for contacts and conversations - name: Custom Filters description: Saved filters for conversations - name: Inboxes description: Communication channels setup - name: Integrations description: Third-party integrations - name: Messages description: Message management APIs - name: Profile description: User profile APIs - name: Reports description: Analytics and reporting APIs - name: Teams description: Team management APIs - name: Webhooks description: Event notification webhooks - name: Automation Rule description: Workflow automation rules - name: Help Center description: Knowledge base management - name: Contacts API description: Public contact APIs - name: Conversations API description: Public conversation APIs - name: Messages API description: Public message APIs - name: CSAT Survey Page description: Customer satisfaction survey - name: Account description: >- The authenticated user's own account — read and update account settings. Distinct from the Platform family's **Accounts**, which provisions accounts across an installation. - name: Audit Logs description: Read the account's audit trail - name: Inbox API description: Public inbox lookup by channel identifier - name: Labels description: >- Create and manage the account's labels. Applying one to a conversation or contact is a separate endpoint under those resources. - name: Macros description: >- Saved multi-step actions an agent — or an integration — can run against one or more conversations. - name: Campaigns description: Ongoing website campaigns and one-off SMS and WhatsApp sends. - name: Contact Notes description: Internal notes on a contact. Never visible to the contact. - name: Help Center Categories description: Categories group a portal's articles, one tree per allowed locale. - name: Help Center Articles description: The articles a portal publishes, and their draft and archived states. - name: Summary Reports description: Per-agent, per-team, per-inbox and per-label totals for a period, as JSON. - name: Live Reports description: Right-now queue counts. No date range — these describe the present. - name: CSAT description: >- The satisfaction ratings contacts have submitted, and the metrics computed from them. - name: Notifications description: >- The per-user notification feed, its read and snooze state, and the settings that decide what lands in it. - name: Conversation Participants description: >- The agents watching a conversation. Participants get notified about it without being assigned to it. - name: Draft Messages description: >- The unsent reply held for a conversation. Stored in Redis, one per conversation. - name: Search description: >- One search service across conversations, contacts, messages and Help Center articles. - name: Dashboard Apps description: Embedded pages that appear as a tab beside a conversation. - name: Assignment Policies description: How conversations are handed out, and which inbox uses which policy. - name: Files description: Storing a file so another endpoint can attach it. - name: Bot Flows description: >- Scripted conversation flows, their versions, and the publish and rollback that move between them. - name: Billing description: >- Credit balance, usage, invoices, spend controls and the provider-hosted payment flows. - name: AMB Templates description: >- Saved Apple Messages primitive payloads an agent can reuse from the composer. - name: AMB Onboarding description: The in-flight Apple Messages for Business registration for an account. - name: Widget Session description: Starting a widget session and reading the visitor it belongs to. - name: Widget Conversation description: The visitor's conversation and its messages. - name: Widget Context description: Campaigns, agents, labels, events and uploads for a widget session. - name: CSAT Survey description: The public, unauthenticated survey a contact answers from a link. - name: Workspace description: Scheduling and cancelling deletion of the whole workspace. paths: /public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations/{conversation_id}/messages/{message_id}: parameters: - $ref: '#/components/parameters/public_inbox_identifier' - $ref: '#/components/parameters/public_contact_identifier' - $ref: '#/components/parameters/conversation_id' - $ref: '#/components/parameters/message_id' patch: tags: - Messages API summary: Update a message description: Update a message operationId: update-a-message requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/public_message_update_payload' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/public_message' example: id: 563 content: Hi — is my order still on track? message_type: 0 content_type: text content_attributes: submitted_values: - name: order_id title: Order value: A-10482 created_at: 1789957537 conversation_id: 169 sender: additional_attributes: avatar_background_color: '#D4F4DD' illustration_avatar_index: 31 custom_attributes: {} email: dana.brooks4821@example.com id: 147 identifier: user-4821 name: Dana Brooks phone_number: null thumbnail: /dashboard/images/default-contact-avatars/031.svg thumbnail_background_color: '#D4F4DD' domain_logo_avatar: false customer_verified: true blocked: false type: contact '401': description: >- Unauthorized. A token that is present but invalid returns this shape; a request with no `api_access_token` header at all returns `{"errors": ["You need to sign in or sign up before continuing."]}`. content: application/json: schema: $ref: '#/components/schemas/error_message' security: [] components: parameters: public_inbox_identifier: in: path name: inbox_identifier schema: type: string required: true description: The identifier obtained from API inbox channel public_contact_identifier: in: path name: contact_identifier schema: type: string required: true description: The source id of contact obtained on contact create conversation_id: in: path name: conversation_id schema: type: integer required: true description: The numeric ID of the conversation message_id: in: path name: message_id schema: type: integer required: true description: The numeric ID of the message schemas: public_message_update_payload: type: object properties: submitted_values: type: object description: Replies to the Bot Message Types properties: name: type: string description: The name of the submiitted value example: My Name title: type: string description: The title of the submitted value example: My Title value: type: string description: The value of the submitted value example: value csat_survey_response: type: object description: The CSAT survey response properties: feedback_message: type: string description: The feedback message of the CSAT survey response example: Great service! rating: type: integer description: The rating of the CSAT survey response example: 5 public_message: type: object properties: id: description: Id of the message type: integer content: type: string description: Text content of the message message_type: description: 0 = incoming, 1 = outgoing, 2 = activity, 3 = template. type: integer enum: - 0 - 1 - 2 - 3 content_type: type: string description: Content type of the message content_attributes: description: >- Structured attributes for the message. Apple Messages primitives arrive here as `amb_primitive_type` plus `amb_primitive_data`. type: object created_at: description: Created at time stamp of the message type: integer format: int64 conversation_id: description: Conversation Id of the message type: integer attachments: type: array items: type: object description: Attachments if any sender: type: object description: Details of the sender error_message: type: object description: >- The shape returned by `render_unauthorized`, `render_not_found_error` and `render_could_not_create_error`. properties: error: type: string description: A single human-readable message. example: Resource could not be found required: - error ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.