Skip to main content
PUT
/
api
/
v1
/
campaigns
/
{campaign_id}
/
sftp
curl -X PUT "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "import_schedule": "hourly",
    "is_enabled": true
  }'

{
  "success": true,
  "data": {
    "id": "sftp-config-uuid-1",
    "import_schedule": "hourly",
    "is_enabled": true,
    "updated_at": "2024-01-15T16:30:00Z"
  }
}

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.

​
Update Campaign SFTP Config

Update a campaign’s SFTP configuration. Enabling (is_enabled: true) requires a successful test connection on file — otherwise the request fails with 422.

​
Endpoint

PUT /api/v1/campaigns/{campaign_id}/sftp

​
Path Parameters

​
campaign_id
string
required
Campaign UUID.

​
Request Headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request Body

Same fields as Create Campaign SFTP Config, all optional, plus:
​
is_enabled
boolean
Toggle integration. Setting to true requires a successful test result.

​
Examples

curl -X PUT "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "import_schedule": "hourly",
    "is_enabled": true
  }'

​
Response

{
  "success": true,
  "data": {
    "id": "sftp-config-uuid-1",
    "import_schedule": "hourly",
    "is_enabled": true,
    "updated_at": "2024-01-15T16:30:00Z"
  }
}

​
Error Responses

​
422 — Cannot Enable

{
  "success": false,
  "message": "Run a successful test connection before enabling SFTP",
  "code": "SFTP_TEST_REQUIRED"
}