CHchariot-giving
sources

Update a Source

Changed on

Updates a custom source. Canonical sources are read-only; a PATCH on one returns 403 Forbidden.

If another source on your account already has the new name, the request returns 409 Conflict.

patch/v1/sources/{id}

Request

  • Base URL
    https://sandboxapi.givechariot.com
  • URL
    https://sandboxapi.givechariot.com/v1/sources/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The unique identifier for the source.

Request body

namestring

The human-readable name of the source.

logostring uri nullable

URL of the source's logo, if one is available.

Example request

{
  "name": "Community Foundation of the Bay Area"
}

Response

The updated source.

idstring required

The unique identifier for the source.

namestring required

The human-readable name of the source.

scope'canonical' | 'custom' required

Who owns this source.

  • canonical — maintained by Chariot and shared across every organization. Read-only.
  • custom — created by an organization for its own use, and mutable by that organization.
logostring uri nullable

URL of the source's logo, if one is available.

created_atstring date-time required

When this source was added to the directory.

updated_atstring date-time required

When this source was last modified.

Example response

{
  "id": "source_01m12tn300eh20gdqscje7s5jw",
  "name": "Fidelity Charitable",
  "scope": "canonical",
  "logo": "https://cdn.givechariot.com/payers/fidelity_charitable.png",
  "created_at": "2026-09-28T12:34:56Z",
  "updated_at": "2026-09-28T12:34:56Z"
}

Changes