Skip to main content
GET
/
api
/
v1
/
campaigns
/
{campaign_id}
/
sftp
/
logs
curl "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp/logs" \
  -H "Authorization: Bearer talq_your_environment_token_here"
{
  "success": true,
  "data": [
    {
      "id": "log-uuid-1",
      "type": "import",
      "status": "succeeded",
      "files_processed": 3,
      "rows_processed": 1840,
      "started_at": "2024-01-15T17:00:01Z",
      "completed_at": "2024-01-15T17:00:42Z"
    },
    {
      "id": "log-uuid-2",
      "type": "export",
      "status": "failed",
      "files_processed": 0,
      "error": "Permission denied on /outbox",
      "started_at": "2024-01-15T16:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total": 18
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

List Campaign SFTP Logs

List recent SFTP import and export jobs for a campaign, including status, file counts, and any errors.

Endpoint

GET /api/v1/campaigns/{campaign_id}/sftp/logs

Path Parameters

campaign_id
string
required
Campaign UUID.

Query Parameters

per_page
integer
Items per page. Range: 1100. Default: 25.
page
integer
Default: 1.

Request Headers

Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

Examples

curl "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp/logs" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "log-uuid-1",
      "type": "import",
      "status": "succeeded",
      "files_processed": 3,
      "rows_processed": 1840,
      "started_at": "2024-01-15T17:00:01Z",
      "completed_at": "2024-01-15T17:00:42Z"
    },
    {
      "id": "log-uuid-2",
      "type": "export",
      "status": "failed",
      "files_processed": 0,
      "error": "Permission denied on /outbox",
      "started_at": "2024-01-15T16:00:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 25,
    "total": 18
  }
}

Status Values

  • running — job in progress
  • succeeded — completed successfully
  • failed — completed with errors
  • cancelled — manually cancelled