Update a Custom Event

1 min

PATCH

https://api.optimizely.com/v2/projects/{project_id}/custom_events/{event_id}

Path Parameters

project_idinteger<int64>required
Description
The project ID of the Project the Custom Event is stored in
Format
int64
event_idinteger<int64>required
Description
The Event ID of the Custom Event you'd like to change
Format
int64

Body Parameters

bodyCustomEventUpdaterequired
Description
A string in JSON format that includes all the fields you'd like to change for a Custom Event
- archivedboolean
  Description
  Whether or not to archive this Event
- categoryEventCategories
  - namestring
- descriptionstring
  Description
  A description of this Event
- keystring
  Example
  loaded_new_app
  Description
  Unique string identifier for this Event within the Project
  Max Length
  64
  Pattern
  ^[a-zA-Z0-9_\- .]+$
- namestring
  Example
  Loaded New App
  Description
  A human readable name for this Event

Responses

200Return the updated Event

CustomEvent
- archivedboolean
  Description
  Whether or not to archive this Event
- categoryEventCategories
  - namestring
- createdstring<date-time>
  Description
  Creation date for this Event
  Format
  date-time
- descriptionstring
  Description
  A description of this Event
- event_propertiesEventProperty[]
  Description
  A set of user-defined data elements for the event. Metrics can filter on particular values of these properties.
  - data_typestring<boolean | number | string>
    Description
    The type of data that can be accepted for this property.
    Allowed
    booleannumberstring
  - namestring
    Description
    The name of the property.
- event_typestring<custom>
  Description
  The type of this Event
  Allowed
  custom
- idinteger<int64>
  Description
  The unique identifier of the Event
  Format
  int64
- is_classicboolean
  Description
  Whether or not this Event is a classic Event. If true, this Event is read-only
  Default
  false
- is_editableboolean
  Description
  Whether or not this Event may be edited
- keystringrequired
  Example
  loaded_new_app
  Description
  Unique string identifier for this Event within the Project
  Max Length
  64
  Pattern
  ^[a-zA-Z0-9_\- .]+$
- namestring
  Example
  Loaded New App
  Description
  A human readable name for this Event. If unspecified, defaults to the key
- project_idinteger<int64>
  Example
  1000
  Description
  The ID of this Event's parent Project
  Format
  int64

400Invalid Project ID supplied

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

401Invalid credentials

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

403You do not have permission to access the specified Event

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

404Event not found

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

defaultUnexpected error

Error
- codestring
- messagestring
- messagesobject
- uuidstring<uuid>
  Format
  uuid

curl

curl --request PATCH \
     --url https://api.optimizely.com/v2/projects/{project_id}/custom_events/{event_id} \
     --header 'accept: application/json'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var requestOptions = {
   method: 'PATCH',
   headers: myHeaders,
   redirect: 'follow'
};

fetch("https://api.optimizely.com/v2/projects/{project_id}/custom_events/{event_id}", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://api.optimizely.com/v2/projects/{project_id}/custom_events/{event_id}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://api.optimizely.com/v2/projects/{project_id}/custom_events/{event_id}"

payload = {}
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("PATCH", url, headers=headers, data=payload)

print(response.text)

200

// Return the updated Event
{
  "archived": false,
  "category": "",
  "created": "",
  "description": "",
  "event_properties": [
    {
      "data_type": "",
      "name": ""
    }
  ],
  "event_type": "",
  "id": "",
  "is_classic": false,
  "is_editable": false,
  "key": "loaded_new_app",
  "name": "Loaded New App",
  "project_id": 1000
}

400

// Invalid Project ID supplied
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

401

// Invalid credentials
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

403

// You do not have permission to access the specified Event
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

404

// Event not found
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

default

// Unexpected error
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}