- Using OGOship OpenAPI
- ApiV1
- Metadata
- Orders
- Products
- Returns
- Stock
- StockUpdate
- WebHooks
- Tracking Service
- Order Service
- Claims
- File a new claim based on orderId
- Get claims by orderId
- Get claim
- Update claim
- Create or update claim
- Get claims search definitions
- Get filtered claims
- Cancel claim.
- Refund claim to ecom.
- Get new claims dashboard data for a channel
- Set owner for a claim
- Remove owner from a claim
- Run action on claims
- Add a tag to a customer claim
- Remove a tag from a customer claim
- Emission
- Fabrikator
- Label
- Location
- Order
- Set order tracking status and tracking time
- Create exchange order
- Send exchange order (set to NEW status in myOGO1)
- Cancel order in myOGO1
- Stop (move to RESERVED status) order in myOGO1
- Search orders. Channel number specifies the location to search from.
- Get order by string orderId
- Create external order
- Update external order
- Get external order by orderId
- Get external orders by channelId
- ReturnDeliveryTypes
- Returns
- Change refund status of both return orders
- Gets list of returns
- Get filter definitions for front end search
- Search for orders with defined filters
- Gets return dashboard data
- Get return by id
- Gets return dashboard data
- Get myOgo2 return by returnId
- Update a myOGO2 return
- Get myOgo2 returns by orderId (Full info for admins or merchants)
- Get myOgo2 returns by orderId (customer version)
- Request a new return. Checks merchant settings and creates a return to myOGO1 if the status of the return is WAITING.
- Get channels myOgo2 returns
- Run actions for returns
- Get filter definitions for front end search
- Approve requested return order.
- Close requested return order.
- Change return order back to requested status.
- Cancel return order.
- Create return to ecom.
- Complete return at ecom.
- Create shipment to tracking service from return order.
- Merge returns.
- Update exchange order to be sent in ecom and/or myOGO.
- Create or update draft return order
- Initialize return from claim
- Initialize return from order
- Finish draft return
- Create exchange order (admin only)
- Send notification to customer about return order
- Get open returns dashboard data for a channel
- Set owner for a return
- Remove owner from a return
- Add a tag to a return order
- Remove a tag from a return order
- Shipment
- Claims
- Notification Service
- ChannelEvents
- Chat
- Get chat conversation by idGET
- Create or update chat conversation (Admin or system only)POST
- Update an existing chat conversationPATCH
- Delete chat conversation (Admin or system only)DELETE
- Get chat conversation by id with messagesGET
- Get chat messages for a conversationGET
- Get all chat conversations for a channelGET
- Create a new chat conversationPOST
- Add a single message to an existing chat conversationPUT
- Set feedback on a chat messagePUT
- /chat/{channelId}/dashboardGET
- Get chat conversation by id
- KlaviyoApi
- Configure Klaviyo integration for a channel with API keys
- Get Klaviyo account details for a channel
- Get lists from Klaviyo
- Get segments from Klaviyo
- Get email templates from Klaviyo
- Create or update a profile in Klaviyo
- Add a profile to a list
- Send a transactional email through Klaviyo
- Track a custom event in Klaviyo
- Update account metrics from Klaviyo
- Remove Klaviyo integration for a channel
- Messaging
- Notifications
- NotificationSettings
- NotificationTemplate
- Get frame for editor
- Update existing frame
- Remove existing frame
- Get frame for editor
- Update existing template
- Get all templates by channel id
- Get all frames by channel id
- Add new template
- Add new frame
- Preview frame
- Preview template
- Preview template to email/SMS
- Get sample model
- Copy all frames from another channel Overwrite: true will overwrite existing frames, false will only copy missing frames
- Copy all templates from another channel Overwrite: true will overwrite existing templates, false will only copy missing templates
- Delete all old frames and templates and copy new ones from source channel to target channel Overwrite input has no effect
- /notificationTemplates/ogoTemplates
- /notificationTemplates/ogoUsageKeys
- SlackApi
- Transactional
- Creates new message
- Gets message
- Updates existing message if exist
- Getting message by id
- Marking message as deleted
- Get all active messages using merchantId identifier. Marks all as read.
- Add transaction to message using merchantId identifier. (Draft = 0, Sent = 1, Read = 2, Skipped = 3, Agreed = 4, Rejected = 5)
- Get's all recipients of message (Draft = 0, Sent = 1, Read = 2, Skipped = 3, Agreed = 4, Rejected = 5)
- Adds recipient to message Returns list of recipients
- Updates all recipients for message
- Simplified add recipient Returns list of recipients for current merchant
- Simplified add recipient Returns list of recipients for current merchant
- Create transaction
- Create transaction
- Generates message token (DEV_ONLY) Crashes API
- WebHook
- ZendeskApi
- Generates a Zendesk OAuth authorization link for the user to authorize the application.
- Handles the OAuth callback from Zendesk after user authorization
- Get tickets from Zendesk for a channel
- Get Zendesk account details for a channel
- Get available groups from Zendesk
- Create a new ticket in Zendesk
- Add a comment to an existing ticket
- Update a ticket's status
- Removes the Zendesk integration for the specified channel
- Schemas
- Schemas
- AddCommentRequest
- AddToListRequest
- ChannelEventOption
- ChannelEventOptionTemplate
- ChannelEventSubscriptionTemplate
- ChannelEventSubscriptionsDto
- ChannelNotificationsSettingsDto
- ChannelNotificationsSettingsUpdateDto
- ProblemDetails
- ChatConversationDto
- ChatConversationUpdateDto
- ChatMessageDto
- ChatParticipantDto
- ConfigureKlaviyoRequest
- ConversationDashboardDto
- ConversationMetadataDto
- ConversationMetadataUpdateDto
- CopySettings
- CreateProfileRequest
- CreateTicketRequest
- CreateTransactionalMessageModel
- CustomWebhookMessage
- EChannelEventOptionType
- EContentType
- EMessageApproval
- EMessageReceiver
- EMessageRecipientStatus
- EMessageRecipientType
- EMessageSource
- EMessageType
- EventDeliveryTypeDto
- EventSubscriptionDto
- Feedback
- FileAttachmentDto
- FrameDetails
- KlaviyoAccountPublicDetails
- LocaleString
- MessageContentDto
- MessageContext
- MessageDto
- MessageFeedbackDto
- NotificationChannels
- NotificationFrameDto
- NotificationProviderSettingsDto
- NotificationTemplateDto
- ProviderResponse
- ProvidersListResponse
- RecipientTransactionsDto
- SendAttachmentDto
- SendDto
- SendEmailRequest
- SendRawDto
- SendTestDto
- SlackTeam
- SlackTeamPublicDetails
- StringStringKeyValuePair
- TemplateLocalizedString
- TrackEventRequest
- TransactionDto
- TransactionalMessageContentDto
- TransactionalMessageDto
- UiDataField
- UiDataFieldOption
- UpdateTicketStatusRequest
- WebHookRedisListModel
- WebHookStatus
- ZendeskAccountPublicDetails
- Schemas
Update an existing chat conversation
Production
https://api.ogoship.com/api
Production
https://api.ogoship.com/api
PATCH
/chat/{merchantId}/{channelId}/{conversationId}
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Path Params
Body Params application/json
Example
{
"participants": [
{
"role": "string",
"name": "string",
"email": "string",
"phone": "string",
"chatUrl": "string"
}
],
"metadata": {
"dataType": "string"
}
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.ogoship.com/api/chat///' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"participants": [
{
"role": "string",
"name": "string",
"email": "string",
"phone": "string",
"chatUrl": "string"
}
],
"metadata": {
"dataType": "string"
}
}'Responses
🟢200OK
text/plain
Body
Example
{
"id": "string",
"channelId": 0,
"merchantId": "c3073b9d-edd0-49f2-a28d-b7ded8ff9a8b",
"lastMessageId": "string",
"lastMessageSender": "string",
"lastMessageText": "string",
"lastMessageSentAt": "2019-08-24T14:15:22.123Z",
"lastFeedback": "Default",
"positiveFeedback": 0,
"negativeFeedback": 0,
"messages": [
{
"id": "string",
"conversationId": "string",
"sender": "string",
"senderName": "string",
"text": "string",
"sentAt": "2019-08-24T14:15:22.123Z",
"feedback": "Default",
"files": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"contentType": "string",
"name": "string",
"url": "string"
}
]
}
],
"participants": [
{
"role": "string",
"name": "string",
"email": "string",
"phone": "string",
"chatUrl": "string"
}
],
"metadata": {
"dataType": "string"
}
}🟠403Forbidden
🟠404Record Not Found
Modified at 2025-08-27 08:28:05