< back to index

HTTP request

GET https://api.wevoteusa.org/apis/v1/challengeNewsItemSave (Jump to "Try It Now")

Required Parameters

Parameter name Value Description
voter_device_id string An 88 character unique identifier linked to a voter record on the server
api_key string (from post, cookie, or get (in that order)) The unique key provided to any organization using the WeVoteServer APIs
challenge_we_vote_id string The we_vote_id for the challenge.

Optional Parameters

Parameter name Value Description
challenge_news_item_we_vote_id string The we_vote_id for the news item.
challenge_news_subject string The subject of the news item.
challenge_news_subject_changed boolean Are we trying to change the challenge news item's subject?
challenge_news_text string The text of the news item.
challenge_news_text_changed boolean Are we trying to change the challenge news item's text?
in_draft_mode boolean Is this item still in draft mode?
in_draft_mode_changed boolean Has the draft mode changed?
visible_to_public boolean Is this item visible to supporters or the public?
visible_to_public_changed boolean Has the visible to public setting changed?

Response

{
  "status": string,
  "success": boolean,
  "challenge_news_subject": string,
  "challenge_news_text": string,
  "challenge_news_item_we_vote_id": string,
  "challenge_we_vote_id": string,
  "date_last_changed": string,
  "date_posted": string,
  "date_sent_to_email": string,
  "in_draft_mode": boolean,
  "organization_we_vote_id": string,
  "speaker_name": string,
  "visible_to_public": boolean,
  "voter_we_vote_id": string,
  "we_vote_hosted_profile_photo_image_url_tiny": string,
}

Response Status Codes

Code Description
VALID_VOTER_DEVICE_ID_MISSING Cannot proceed. A valid voter_device_id parameter was not included.
VALID_VOTER_ID_MISSING Cannot proceed. A valid voter_id was not found.

Try It Now: API Variables

Parameter name Value  
voter_device_id:
challenge_we_vote_id:
challenge_news_item_we_vote_id:
challenge_news_subject:
challenge_news_subject_changed: True
False
challenge_news_text:
challenge_news_text_changed: True
False
in_draft_mode: True
False
in_draft_mode_changed: True
False
visible_to_public: True
False
visible_to_public_changed: True
False

(opens in new window)