Skip to main content
PATCH
/
api
/
v1
/
campaigns
/
{id}
Update Campaign
curl --request PATCH \
  --url https://api.ravan.ai/api/v1/campaigns/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "agentId": "<string>",
  "phoneNumberId": "<string>",
  "fromPhoneNumber": "<string>",
  "status": "<string>",
  "executionStatus": "<string>",
  "schedule": {
    "start": "<string>",
    "end": "<string>",
    "windowStart": "<string>",
    "windowEnd": "<string>",
    "windowDays": [
      123
    ],
    "timezone": "<string>",
    "maxConcurrent": 123,
    "retryAttempts": 123,
    "retryGapMin": 123
  }
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "id": "<string>",
    "organizationId": "<string>",
    "name": "<string>",
    "agentId": "<string>",
    "phoneNumberId": "<string>",
    "fromPhoneNumber": "<string>",
    "status": "<string>",
    "executionStatus": "<string>",
    "schedule": {
      "start": "<string>",
      "end": "<string>",
      "windowStart": "<string>",
      "windowEnd": "<string>",
      "windowDays": [
        123
      ],
      "timezone": "<string>",
      "maxConcurrent": 123,
      "retryAttempts": 123,
      "retryGapMin": 123
    },
    "contactStats": {
      "total": 123,
      "contacted": 123,
      "successful": 123,
      "failed": 123,
      "noAnswer": 123,
      "pending": 123,
      "inProgress": 123
    },
    "startedAt": "<string>",
    "completedAt": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "outboundMaxConcurrent": 123,
    "outboundMaxCps": 123
  }
}
Actual endpoint: PATCH https://api.ravan.ai/api/v1/campaigns/{id}/

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header. Find or rotate it from your Ravan AI account settings.

​
Path Parameters

​
id
string
required
The unique ID of the campaign to update. Use the id returned by the List or Create Campaign endpoint.

​
Body

​
id
string
The campaign ID (can be included in the body).
​
name
string
The internal name of the campaign.
​
agentId
string
The unique ID of the agent assigned to this campaign.
​
phoneNumberId
string
The phone number record ID to use for this campaign.
​
fromPhoneNumber
string
The caller ID used for outbound calls, in E.164 format.
​
status
string
Campaign status: draft, active, paused, completed.
​
executionStatus
string
Execution state: draft, running, paused, completed.
​
schedule
object
Campaign schedule settings.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message. Example: Campaign updated successfully
​
data
object
Updated campaign object.