How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Convert Version Changes API

Each **Experience's Variation** has one or more **Changes**; a change represent the actual modification thatis applied to a visitor. It can be a piece of javascript or CSS code for web experiences or it can be a string value for examplein case of a fullstack experience.

Convert Version Changes API is one of 33 APIs that Convert publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Version Changes. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 1 path, and defines 25 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against 3 base URLs: https://api.convert.com/api/v2, https://apidev.convert.com/api/v2, http://apidev.convert.com:5000/api/v2.

2 operations 1 paths 25 schemas 1 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://api.convert.com/api/v2
Authentication
API Key, HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 3

Convert Version Changes API declares 3 security schemes for authenticating requests. An API key is passed in the header as Authorization (requestSigning). It accepts HTTP bearer tokens (secretKey). An API key is passed in the cookie as sid (cookieAuthentication).

  • requestSigning — See [API Key Authentication](tag/API-KEY-Authentication) for more information.
  • secretKey — See [API Key Authentication](tag/API-KEY-Authentication) for more information.
  • cookieAuthentication — Cookie authentication is used against Convert's own IdentityProvider or third party identity providers and is described more in the "[Cookie Authentication](ta…

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Version Changes 2

Each Experience's Variation has one or more Changes; a change represent the actual modification that is applied to a visitor. It can be a piece of javascript or CSS code for web e…

GET
/accounts/{account_id}/projects/{project_id}/experiences/{experience_id}/changes/{change_id}
Get details of a specific change in a variation
getExperienceChange 4 params → 200default
PUT
/accounts/{account_id}/projects/{project_id}/experiences/{experience_id}/changes/{change_id}
Update a specific change in a variation
updateExperienceChange 4 params body → 200default

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are ErrorData (3 properties), ExperienceChangeBase (2 properties), ExperienceChangeIdReadOnly (1 property). Each schema is shown below with its type and property counts.

ExperienceChangeRichStructureDataBase
object
Defines a complex change, often involving multiple DOM manipulations or structured data, typically generated by advanced Visual Editor interactions or specific…
ExperienceChangeRichStructureData
object
Represents a 'richStructure' type change, including its system-assigned ID.
ExperienceChangeDefaultCodeDataAdd
object
Data for creating a new 'defaultCode' type change.
ExperienceChangeBase
object
The fundamental structure representing a single modification applied within an experience's variation. The specific content and behavior of the change are dete…
2 properties
ExperienceChangeDefaultRedirectData
object
Represents a 'defaultRedirect' type change, including its system-assigned ID.
ErrorData
object
3 properties
ExperienceChangeFullStackFeatureAdd
object
Data for creating a new 'fullStackFeature' type change.
ExperienceChangeAdd
Data structure for adding a new change to an experience variation. The id field is omitted as it will be assigned upon creation.
ExperienceChangeDefaultCodeMultipageData
object
Represents a 'defaultCodeMultipage' type change, including its system-assigned ID.
ExperienceChangeDefaultCodeMultipageDataBase
object
Defines a standard code-based change that applies to a specific page within a Multi-page Funnel experiment. This allows different code (CSS, JS) to be applied…
ConcurrencyKey
string
A server-generated hash that represents the object's state at the time of retrieval. When included in an update request, the operation will only succeed if the…
UpdateExperienceChangeRequestData
ExperienceChangeDefaultRedirectDataAdd
object
Data for creating a new 'defaultRedirect' type change.
ExperienceChangeRichStructureDataAdd
object
Data for creating a new 'richStructure' type change.
ExperienceChangeFullStackFeature
object
Represents a 'fullStackFeature' type change, including its system-assigned ID.
ExperienceChangeDefaultCodeMultipageDataAdd
object
Data for creating a new 'defaultCodeMultipage' type change.
ExperienceChangeCustomCodeDataAdd
object
Data for creating a new 'customCode' type change.
ExperienceChangeDefaultCodeDataBase
object
Defines a standard code-based change, typically generated by the Visual Editor for modifications like text replacement, style changes, or element removal. It c…
ExperienceChangeDefaultRedirectDataBase
object
Defines a URL redirect, typically used in Split URL experiments. It specifies how to match an original URL and construct the URL for the variation page.
ExperienceChangeIdReadOnly
object
Represents the unique identifier of a change, typically when returned by the API after creation or in a list.
1 property
ExperienceChangeFullStackFeatureBase
object
Defines a change for a Full Stack experiment that involves enabling or configuring a specific 'Feature' and its variables for this variation.
ExperienceChange
Represents a single, specific modification applied as part of an experience's variation. The exact structure and content depend on the type of change.
ExperienceChangeCustomCodeDataBase
object
Defines a change applied purely through custom-written CSS and/or JavaScript code, bypassing the Visual Editor's generated code. This offers maximum flexibilit…
ExperienceChangeCustomCodeData
object
Represents a 'customCode' type change, including its system-assigned ID.
ExperienceChangeDefaultCodeData
object
Represents a 'defaultCode' type change, including its system-assigned ID.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

convert-version-changes-api-openapi.yml Raw ↑

Other APIs Convert publishes across the network.

Convert Experiences REST API v2
Convert Accounts API
Convert AI content API
Convert API Keys API
Convert Audiences API
Convert Bulk API
Convert Cdn Images API
Convert Collaborators API
Convert Cookie Authentication API
Convert Domains API
Convert Experience Sections API
Convert Experience Variations API
Where this information came from

This is an independent, third-party profile of Convert Version Changes API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.