Skip to main content
PUT
Update a Gift Ask

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

giftAskId
string
required

(Required) The gift ask identifier.

Body

application/json
askAmount
string<style>

The amount being asked for.

askDate
string

The date the ask was made.

expectedFulfillmentDate
string<style>

The date the pledge is expected to be paid in full.

notes
string

Free-text notes stored on the record.

askType
string<style>

The type of ask, for example a solicitation or a proposal.

frequency
string

How often the requested gift would recur, for one-time or recurring asks.

declined
string<style>

When true, the ask was declined by the donor.

projectId
string

The identifier of the project this record is designated to.

segmentId
string<style>

The identifier of the segment this record is attributed to.

assignedUserId
string

The identifier of the user responsible for the record.

secondaryAssignedUserId
string<style>

The identifier of a second user responsible for the record.

status
string

The current status of the record.

customFields
object[]

Custom field values to set on the record. Field names must match custom fields configured for the organization.

Response

OK

id
string

The unique identifier of the record in Virtuous.

giftAskUrl
string
giftsAppliedUrl
string
contactId
string

The identifier of the contact this record belongs to.

contactUrl
string

A link to the related contact.

askAmount
string
askAmountFormatted
string

The askAmount value, formatted for display.

askDate
string
askDateFormatted
string

The askDate value, formatted for display.

expectedFulfillmentDate
string
expectedFulfillmentDateFormatted
string

The expectedFulfillmentDate value, formatted for display.

notes
string
askType
string
frequency
string
declined
string
createDateTimeUtc
string

The UTC date and time the record was created.

createdByUser
string

The name of the user who created the record.

modifiedDateTimeUtc
string

The UTC date and time the record was last modified.

modifiedByUser
string

The name of the user who last modified the record.

projectId
string

The identifier of the project this record is designated to.

project
string
projectUrl
string

A link to the related project.

segmentId
string

The identifier of the segment this record is attributed to.

segment
string
segmentCode
string
segmentUrl
string

A link to the related segment.

assignedUserId
string
assignedUser
string
secondaryAssignedUser
string
secondaryAssignedUserId
string
status
string
customFields
object[]

The custom field values stored on the record.

Last modified on August 11, 2026