List Extensions

1 min

GET

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

List Extensions under a project

Query Parameters

per_pageinteger
Description
Optional pagination argument that specifies the maximum number of objects to return per request
Default
25
Maximum
100
pageinteger
Description
Optional pagination argument that specifies the page to return. If you have 140 objects and you choose to return 100 objects per page you will be able to access the last 40 objects on page 2. The default value is 1.
Default
1
project_idinteger<int64>required
Description
The ID of the project you would like to list all extensions for
Format
int64

Responses

200Return all extensions in the specified project

Extension[]
- archivedboolean
  Description
  Whether the extension is archived
- createdstring<date-time>
  Description
  The time when the extension was initially created
  Format
  date-time
- descriptionstring
  Description
  The description for the extension
- edit_urlstringrequired
  Description
  The URL to load when editing the extension
- enabledboolean
  Description
  Whether the extension is enabled. A disabled extension won't appear in the editor and won't be built into the snippet
- experiment_countinteger<int64>
  Example
  3
  Description
  Number of experiments that reference this extension across all statuses (running, paused, draft, archived). Computed by the upstream service.
  Format
  int64
- fieldsField[]
  Description
  Array of editable fields in the extension
  - api_namestringrequired
    Description
    The API name of the field
  - default_valuestringrequired
    Description
    A string in JSON format that corresponds to the default_value of the field
  - field_typestring<selector | text | multi_text | rich_text | number | html | css | js | toggle | dropdown | multi_select | image | color | slider>required
    Description
    The type of the field
    Allowed
    selectortextmulti_textrich_textnumberhtmlcssjstoggledropdownmulti_selectimagecolorslider
  - labelstringrequired
    Description
    The label of the field
  - optionsOptions
    - choicesChoices[]
      Description
      The choices for a field
      - labelstring
        Description
        label of the choice
      - valuestring
        Description
        value of the choice
- idinteger<int64>
  Example
  3000
  Description
  The unique identifier for the extension
  Format
  int64
- implementationImplementationrequired
  - apply_jsstring
    Description
    The Apply JS code is used to inject the extension onto the page
    Default
  - cssstring
    Description
    Some extensions may not need any CSS because they inherit styles from the page itself. However, you can add additional styling here. This will be injected on the page through a tag
    Default
  - htmlstring
    Description
    The html implementation of the field
    Default
  - reset_jsstring
    Description
    Reset JS is used to "clean up" after a extension. It's used in the editor, when changing field values or removing an existing extension. Reset JS should remove the element and any other side-effects
    Default
- last_modifiedstring<date-time>
  Description
  The last time when the extension was modified
  Format
  date-time
- namestringrequired
  Example
  My Extension
  Description
  Name of the extension
- project_idinteger<int64>required
  Example
  1000
  Description
  The project the extension is in
  Format
  int64

401Invalid credentials

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

403You do not have permission to access the extensions in the specified project

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

404Extensions not found

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

defaultUnexpected error

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

curl

curl --request GET \
     --url 'https://api.optimizely.com/v2/extensions?per_page=25&page=1&project_id=integer%3Cint64%3E' \
     --header 'accept: application/json'

javascript

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

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

fetch("https://api.optimizely.com/v2/extensions?per_page=25&page=1&project_id=integer<int64>", 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/extensions?per_page=25&page=1&project_id=integer<int64>")

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

request = Net::HTTP::Get.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/extensions?per_page=25&page=1&project_id=integer<int64>"

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

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

print(response.text)

200

// Return all extensions in the specified project
[
  {
    "archived": false,
    "created": "",
    "description": "",
    "edit_url": "",
    "enabled": false,
    "experiment_count": 3,
    "fields": [
      {
        "api_name": "",
        "default_value": "",
        "field_type": "",
        "label": "",
        "options": {
          "choices": [
            {
              "label": "",
              "value": ""
            }
          ]
        }
      }
    ],
    "id": 3000,
    "implementation": {
      "apply_js": "",
      "css": "",
      "html": "",
      "reset_js": ""
    },
    "last_modified": "",
    "name": "My Extension",
    "project_id": 1000
  }
]

401

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

403

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

404

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

default

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