USusefathom
Events

Update event

Changed on

Previously updated an event by its goal code. This endpoint is no longer available.

Permissions: Requires write access to the site (manage:{site_id}).

post/sites/{site_id}/events/{event_id}

Request

  • Base URL
    https://api.usefathom.com/v1
  • URL
    https://api.usefathom.com/v1/sites/{site_id}/events/{event_id}
  • Auth
    HTTP bearer

Path parameters

site_idstring required
Example:CDBUGS

The ID of the site. This is the same string you use in your tracking code. Example: CDBUGS

event_idstring required
Example:ABCDEFGH

The id (tracking code) of the event you wish to update. Example: ABCDEFGH

Request body

namestring

The name of the event (up to 255 characters).

currency'dollar' | 'pound' | 'euro' | 'yuan' | 'peso' | 'shekel' | 'yen' | 'won' | 'hryvnia' | 'franc' | 'rupee' | 'integer' | 'none'

The currency used for any value attached to this event's completions.

Example request

{
  "name": "Purchase early access (live)"
}

Changes

  • 93547ee49398Revision changes
    • breaking

      removed the success response with the status

    • info

      endpoint deprecated

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      removed the non-success response with the status

  • 50679caad756Revision changes
    • breaking

      added the new path request parameter event_id

    • breaking

      added the new path request parameter site_id

    • info

      api operation id updateEvent was added

    • info

      api tag Events added

    • info

      added the new optional request property

    • info

      request body became optional

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status