Mark conversation as done

Mark a conversation as done, removing it from the inbox without sending a message. Returns the updated conversation.

POST /v1/conversations/{conversationId}/mark-as-done

Mark conversation as done

cURL

curl --request POST \
  --url https://dev-public-api.openphone.dev/v1/conversations/{conversationId}/mark-as-done \
  --header 'Authorization: <api-key>'

200

{
  "assignedTo": "US123abc",
  "createdAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z",
  "id": "CN123abc",
  "lastActivityAt": "2023-11-07T05:31:56Z",
  "lastActivityId": "AC123abc",
  "mutedUntil": "2023-11-07T05:31:56Z",
  "name": "Chat with customer",
  "participants": [
    "[phone]"
  ],
  "phoneNumberId": "PN123abc",
  "snoozedUntil": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "<string>",
  "code": "<string>",
  "status": 123,
  "docs": "<string>",
  "title": "<string>",
  "trace": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>",
      "schema": {
        "type": "<string>"
      },
      "value": "<unknown>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "status": 123,
  "docs": "<string>",
  "title": "<string>",
  "trace": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>",
      "schema": {
        "type": "<string>"
      },
      "value": "<unknown>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "status": 123,
  "docs": "<string>",
  "title": "<string>",
  "description": "<string>",
  "trace": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>",
      "schema": {
        "type": "<string>"
      },
      "value": "<unknown>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "status": 123,
  "docs": "<string>",
  "title": "<string>",
  "trace": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>",
      "schema": {
        "type": "<string>"
      },
      "value": "<unknown>"
    }
  ]
}

{
  "message": "<string>",
  "code": "<string>",
  "status": 123,
  "docs": "<string>",
  "title": "<string>",
  "trace": "<string>",
  "errors": [
    {
      "path": "<string>",
      "message": "<string>",
      "schema": {
        "type": "<string>"
      },
      "value": "<unknown>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Path Parameters

conversationId · string · required

The unique identifier of the conversation to mark as done.

Pattern: ^CN(.*)$

Example:

"CN123abc"

Response

200

application/json

OK

assignedTo · Option 1 · string Option 2 · string · required

The unique identifier of the user or system user the conversation is assigned to.

Pattern: ^US(.*)$

Example:

"US123abc"

createdAt · string<date-time> | null · required

deletedAt · string<date-time> | null · required

id · string · required

The unique identifier of the conversation.

Pattern: ^CN(.*)$

Example:

"CN123abc"

lastActivityAt · string<date-time> | null · required

lastActivityId · string | null · required

The unique identifier of the most recent activity in the conversation.

Pattern: ^AC(.*)$

Example:

"AC123abc"

mutedUntil · string<date-time> | null · required

name · string | null · required

The custom name of the conversation. Will be null if no custom name is set.

Example:

"Chat with customer"

participants · string[] · required

A phone number in E.164 format, including the country code.

Pattern: ^\+[1-9]\d{1,14}$

phoneNumberId · string · required

The unique identifier of the Quo phone number associated with the conversation.

Pattern: ^PN(.*)$

Example:

"PN123abc"

snoozedUntil · string<date-time> | null · required

updatedAt · string<date-time> | null · required