Skip to main content
PATCH
/
projects
/
{id}
Update Project
curl --request PATCH \
  --url https://api.politicalcomms.com/v1/projects/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "Spring Outreach (revised)",
  "message_text": "Hi {first_name}, early voting starts Monday. Learn more: {link}",
  "media_ids": []
}
'
{
  "success": true,
  "data": {
    "id": "proj_abc123",
    "name": "Spring Outreach (revised)",
    "status": "draft",
    "message_text": "Hi {first_name}, early voting starts Monday. Learn more: {link}",
    "updated_at": "2026-03-21T09:30:00Z"
  }
}

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy.

Path Parameters

​
id
string
required

Resource ID

Body

application/json
​
name
string
​
message_text
string
​
protocol
enum<string>
Available options:
sms,
mms
​
phone_number_ids
string[]

Replace the project's sending phone numbers (1-49). New conversations rotate across them; existing conversations keep their already-assigned sticky number.

Required array length: 1 - 49 elements
​
phone_number_id
string
deprecated

Deprecated — use phone_number_ids. A single id is treated as a one-element phone_number_ids.

​
contact_list_ids
string[]
Minimum array length: 1
​
suppression_list_ids
string[]
​
media_ids
string[]
​
link_tracking_enabled
boolean
​
link_tracking_destination_url
string<uri> | null
​
link_tracking_domain_id
string | null
​
link_tracking_param_field
string | null

Contact field appended as a redirect query param on tracking links ('phone', a custom-field name, or null for none).

Maximum string length: 64

Response

Project updated