Create an Attribute

1 min

POST

https://api.optimizely.com/v2/attributes

Create an Attribue

Body Parameters

bodyAttributerequired
Description
A string in JSON format that includes all the fields to create a new Attribute
- archivedboolean
  Description
  Whether or not the Attribute has been archived
  Default
  false
- descriptionstring
  Description
  A short description of the Attribute
- keystringrequired
  Example
  subscriber_status
  Description
  Unique string identifier for this Attribute within the project
  Max Length
  64
  Pattern
  ^[a-zA-Z0-9_\- .]+$
- namestring
  Example
  Subscriber Status
  Description
  The name of the Attribute. For Full Stack projects, the name will be set to the value of the key.
- project_idinteger<int64>required
  Example
  17738411154
  Description
  The ID of the project the Attribute belongs to
  Format
  int64

Responses

201Successfully created the Attribute

Attribute
- archivedboolean
  Description
  Whether or not the Attribute has been archived
  Default
  false
- condition_typestring<custom_attribute | custom_dimension>
  Description
  Whether this Attribute is a custom dimension or custom attribute. If this is a custom dimension, it belongs to an Optimizely Classic experiment and is read-only.
  Default
  custom_attribute
  Allowed
  custom_attributecustom_dimension
- descriptionstring
  Description
  A short description of the Attribute
- idinteger<int64>
  Description
  The unique identifier for the Attribute
  Format
  int64
- keystringrequired
  Example
  subscriber_status
  Description
  Unique string identifier for this Attribute within the project
  Max Length
  64
  Pattern
  ^[a-zA-Z0-9_\- .]+$
- last_modifiedstring<date-time>
  Description
  The last time the Attribute was modified
  Format
  date-time
- namestring
  Example
  Subscriber Status
  Description
  The name of the Attribute. For Full Stack projects, the name will be set to the value of the key.
- project_idinteger<int64>required
  Example
  17738411154
  Description
  The ID of the project the Attribute belongs to
  Format
  int64

400Invalid request body content

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

401Invalid credentials

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

defaultUnexpected error

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

curl

curl --request POST \
     --url https://api.optimizely.com/v2/attributes \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "key": "subscriber_status",
     "project_id": 17738411154
     }'

javascript

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

var raw = JSON.stringify({
   "key": "subscriber_status",
   "project_id": 17738411154
});

var requestOptions = {
   method: 'POST',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://api.optimizely.com/v2/attributes", 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/attributes")

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

request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "key": "subscriber_status",
   "project_id": 17738411154
})

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

python

import requests
import json

url = "https://api.optimizely.com/v2/attributes"

payload = json.dumps({
   "key": "subscriber_status",
   "project_id": 17738411154
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

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

print(response.text)

201

// Successfully created the Attribute
{
  "archived": false,
  "condition_type": "",
  "description": "",
  "id": "",
  "key": "subscriber_status",
  "last_modified": "",
  "name": "Subscriber Status",
  "project_id": 17738411154
}

400

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

401

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

default

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