S
Samva
S
Samva
DashboardAPISamva DocumentationQuickstart GuideAuthentication

API Reference

Email Management

Conversation Management

Create ConversationGet ConversationList ConversationsAdd Participants to ConversationRemove Participants from ConversationUpdate Conversation

Configuration

Analytics & Operations

OpenAPI Specification
API ReferenceConversations

List Conversations

GET
/conversations

Authorization

apiKey
X-API-Key<token>

API key for authentication

In: header

Query Parameters

page?integer
Default1
Range1 <= value <= 9007199254740991
limit?integer
Default20
Range1 <= value <= 100
filters?

Response Body

application/json

curl -X GET "https://samva.app/api/v1/conversations"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "organizationId": "7bc05553-4b68-44e8-b7bc-37be63c6d9e9",
      "title": "string",
      "description": "string",
      "externalId": "string",
      "parentConversationId": "2314ba74-0ed2-497a-9dc0-620a31a0f6d4",
      "channels": [
        "sms"
      ],
      "primaryChannel": "sms",
      "status": "active",
      "statusReason": "string",
      "priority": -2147483648,
      "urgency": "low",
      "complexity": "simple",
      "metadata": "string",
      "participantTracking": "string",
      "metrics": "string",
      "context": "string",
      "tags": [
        "string"
      ],
      "categories": [
        "string"
      ],
      "isTest": true,
      "isInternal": true,
      "isPrivate": true,
      "startedAt": "2019-08-24T14:15:22Z",
      "lastActivityAt": "2019-08-24T14:15:22Z",
      "lastHumanActivityAt": "2019-08-24T14:15:22Z",
      "resolvedAt": "2019-08-24T14:15:22Z",
      "archivedAt": "2019-08-24T14:15:22Z",
      "resolvedBy": "14b2aa2a-efb0-4ef1-9ffc-3025efbd2222",
      "resolutionType": "automated",
      "resolutionNotes": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e"
    }
  ],
  "pagination": {
    "page": -9007199254740991,
    "limit": -9007199254740991,
    "total": -9007199254740991,
    "totalPages": -9007199254740991
  }
}

Get Conversation

Previous Page

Add Participants to Conversation

Next Page

curl -X GET "https://samva.app/api/v1/conversations"