Update a List Attribute

1 min

PATCH

https://api.optimizely.com/v2/list_attributes/{list_attribute_id}

Overwrite the List Attribute with the provided id. Required arguments are identical to creating a new List Attribute.

Path Parameters

list_attribute_idinteger<int64>required
Description
The ID of the List Attribute you'd like to update
Format
int64

Body Parameters

bodyListAttributeUpdaterequired
Description
A string in JSON format that includes all the fields you'd like to change for a List Attribute
- archivedboolean
  Description
  Whether or not the List Attribute has been archived
- descriptionstring
  Description
  A short description of the List Attribute
- key_fieldstring
  Description
  The name of the object which holds targeting ids on your website
- list_contentstring
  Description
  A comma separated string of IDs or ZIP Codes. Items will be matched against the key_field to determine if an active visitor should be targeted by the list. Note that if the list currently contains data, providing this value will overwrite the previous data.
- list_typestring<cookies | query_parameters | zip_codes | js_variables>
  Description
  The type of data object which holds targeting ids on your website (cookies, query parameters, zip codes, Global JS variables)
  Allowed
  cookiesquery_parameterszip_codesjs_variables
- namestring
  Example
  SubscriberStatus
  Description
  A unique, human-readable name for the List Attribute
  Pattern
  ^[-_0-9A-Za-z]+$

Responses

200Successfully updated the List Attribute

ListAttribute
- account_idinteger<int64>
  Description
  The unique identifier for the Optimizely account
  Format
  int64
- archivedboolean
  Description
  Whether or not the List Attribute has been archived
  Default
  false
- aws_access_keystring
  Description
  AWS access key to upload List Attribute source file to S3
- aws_secret_keystring
  Description
  AWS secret key to upload List Attribute source file to S3
- createdstring<date-time>
  Description
  Time when the List Attribute was created
  Format
  date-time
- descriptionstring
  Description
  A short description of the List Attribute
- idinteger<int64>
  Description
  The unique identifier for the List Attribute
  Format
  int64
- key_fieldstringrequired
  Description
  The name of the object which holds targeting ids on your website
- last_modifiedstring<date-time>
  Description
  The last time the List Attribute was modified
  Format
  date-time
- list_contentstring
  Description
  A comma separated string of IDs or ZIP Codes. Items will be matched against the key_field to determine if an active visitor should be targeted by the list. Note that if the list currently contains data, providing this value will overwrite the previous data.
- list_typestring<cookies | query_parameters | zip_codes | js_variables>
  Description
  The type of data object which holds targeting ids on your website (cookies, query parameters, zip codes, Global JS variables)
  Allowed
  cookiesquery_parameterszip_codesjs_variables
- namestringrequired
  Example
  SubscriberStatus
  Description
  A unique, human-readable name for the List Attribute
  Pattern
  ^[-_0-9A-Za-z]+$
- project_idinteger<int64>required
  Description
  The ID of the project the List Attribute belongs to
  Format
  int64
- s3_pathstring
  Description
  S3 path containing files used to populate the List Attribute with data. Can be used with an S3 client or CLI to upload data.

400Invalid request body content

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

401Invalid credentials

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

403You do not have permission to update the specified List Attribute.

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

404List Attribute 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/list_attributes/{list_attribute_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/list_attributes/{list_attribute_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/list_attributes/{list_attribute_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/list_attributes/{list_attribute_id}"

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

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

print(response.text)

200

// Successfully updated the List Attribute
{
  "account_id": "",
  "archived": false,
  "aws_access_key": "",
  "aws_secret_key": "",
  "created": "",
  "description": "",
  "id": "",
  "key_field": "",
  "last_modified": "",
  "list_content": "",
  "list_type": "",
  "name": "SubscriberStatus",
  "project_id": "",
  "s3_path": ""
}

400

// Invalid request body content
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

401

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

403

// You do not have permission to update the specified List Attribute.
{
  "code": "",
  "message": "",
  "messages": {},
  "uuid": ""
}

404

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

default

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