Integration Status

Get the current status and details of an integration

GET /integrations/{integration_id}/status

cURL

curl -X GET 'https://api.memchat.io/integrations/int_linkedin_123/status' \
  -H 'X-API-Key: YOUR_API_KEY'

Processing Response

{
  "integration_id": "int_linkedin_123",
  "type": "social",
  "platform": "linkedin",
  "status": "processing",
  "progress": {
    "percentage": 65,
    "current_step": "extracting_posts",
    "total_steps": 4,
    "estimated_completion": "2024-01-15T16:45:00Z"
  },
  "stats": {
    "items_processed": 95,
    "items_total": 147,
    "memories_created": 67,
    "errors_count": 3,
    "processing_time": 145
  },
  "last_activity": "2024-01-15T16:32:15Z",
  "created_at": "2024-01-15T16:30:00Z",
  "errors": [
    {
      "error_id": "err_001",
      "message": "Failed to parse post content",
      "code": "PARSE_ERROR",
      "timestamp": "2024-01-15T16:31:30Z",
      "item_id": "post_xyz789"
    }
  ]
}

Retrieves the current status, progress, and details of a specific integration.

cURL

curl -X GET 'https://api.memchat.io/integrations/int_linkedin_123/status' \
  -H 'X-API-Key: YOUR_API_KEY'

Path Parameters

integration_id · string · required

The unique identifier of the integration

Query Parameters

include_logs · boolean · default: "false"

Whether to include processing logs in the response

include_errors · boolean · default: "true"

Whether to include error details in the response

Response

integration_id · string

Unique identifier of the integration

type · string

Integration type: social, file, chat, api

platform · string

Platform or service name (e.g., linkedin, chatgpt, pdf)

status · string

Current status: pending, processing, completed, failed, cancelled

progress · object

Progress information for the integration

Show Progress Details

percentage · number

Completion percentage (0-100)

current_step · string

Current processing step

total_steps · number

Total number of steps

estimated_completion · string

Estimated completion time (ISO 8601)

stats · object

Processing statistics

Show Statistics

items_processed · number

Number of items processed so far

items_total · number

Total number of items to process

memories_created · number

Number of memories successfully created

errors_count · number

Number of errors encountered

processing_time · number

Processing time in seconds

last_activity · string

ISO 8601 timestamp of last processing activity

created_at · string

ISO 8601 timestamp when integration was created

completed_at · string

ISO 8601 timestamp when integration completed (if finished)

errors · array

List of errors encountered (if include_errors=true)

Show Error Details

error_id · string

Unique identifier for the error

message · string

Error message

code · string

Error code

timestamp · string

When the error occurred

item_id · string

ID of the item that caused the error

logs · array

Processing logs (if include_logs=true)

Show Log Entries

timestamp · string

Log entry timestamp

level · string

Log level: info, warning, error

message · string

Log message

step · string

Processing step

Processing Response

{
  "integration_id": "int_linkedin_123",
  "type": "social",
  "platform": "linkedin",
  "status": "processing",
  "progress": {
    "percentage": 65,
    "current_step": "extracting_posts",
    "total_steps": 4,
    "estimated_completion": "2024-01-15T16:45:00Z"
  },
  "stats": {
    "items_processed": 95,
    "items_total": 147,
    "memories_created": 67,
    "errors_count": 3,
    "processing_time": 145
  },
  "last_activity": "2024-01-15T16:32:15Z",
  "created_at": "2024-01-15T16:30:00Z",
  "errors": [
    {
      "error_id": "err_001",
      "message": "Failed to parse post content",
      "code": "PARSE_ERROR",
      "timestamp": "2024-01-15T16:31:30Z",
      "item_id": "post_xyz789"
    }
  ]
}

Status Types

Pending

Integration is queued and waiting to start processing.

Processing

Integration is currently being processed. Check progress for details.

Completed

Integration has finished successfully. All processable items have been handled.

Failed

Integration failed due to a critical error. Check errors array for details.

Cancelled

Integration was cancelled by the user or system before completion.

Processing Steps

Different integration types have different processing steps:

Social Media Integration

1. authentication - Validating access tokens
2. discovery - Finding available content
3. extraction - Downloading content
4. processing - Creating memories from content

File Integration

1. upload - Receiving and storing file
2. parsing - Extracting text content
3. chunking - Breaking content into chunks
4. memory_creation - Creating memories from chunks

Chat Integration

1. validation - Validating chat data format
2. conversation_detection - Identifying conversations
3. content_extraction - Extracting meaningful content
4. memory_creation - Creating memories from conversations

Error Responses

404 · object

Integration not found

{
  "error": "Integration not found",
  "code": "INTEGRATION_NOT_FOUND",
  "integration_id": "int_invalid_123"
}

401 · object

Unauthorized access

{
  "error": "Invalid or expired token",
  "code": "UNAUTHORIZED"
}

Real-time Updates

For real-time status updates, consider using:

• Webhooks: Configure webhook endpoints to receive status updates
• Polling: Poll this endpoint every 10-30 seconds during processing
• WebSocket: Connect to the WebSocket endpoint for live updates (coming soon)