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

Optimizely Structured Contents API

The Structured Contents API from Optimizely — 11 operation(s) for structured contents.

Optimizely Structured Contents API is one of 420 APIs that Optimizely publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Structured Contents. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 17 operations across 11 paths, and defines 60 schemas. It is described by OpenAPI 3.2.0, at version V3.

Requests are made against a single base URL, https://api.cmp.optimizely.com/v3.

17 operations 11 paths 60 schemas 1 DELETE6 GET1 PATCH9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
V3
Base URL
https://exp.mcp.opal.optimizely.com/mcp
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Optimizely Structured Contents API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode and clientCredentials flows, exposing 3 scopes. By default, every request must be authenticated.

Paths & Operations 17

Across 11 paths, the API surfaces 17 operations — 1 DELETE, 6 GET, 1 PATCH, 9 POST. Each is listed below with its method, path, parameters, and response codes.

Structured Contents 17
GET
/structured-content/content-types
GET /structured-content/content-types
listSCContentTypes 3 params → 200422
POST
/structured-content/content-types
POST /structured-content/content-types
createSCContentType body → 200201422
GET
/structured-content/content-types/{content_type_id}
GET /structured-content/content-types/{contenttypeid}
getSCContentType 1 param → 200422
POST
/structured-content/content-types/{content_type_id}
POST /structured-content/content-types/{contenttypeid}
updateSCContentType 1 param body → 200422
GET
/structured-content/content-types/{content_type_id}/versions
GET /structured-content/content-types/{contenttypeid}/versions
listSCContentTypeVersions 1 param → 200422
POST
/structured-content/content-types/{content_type_id}/versions
POST /structured-content/content-types/{contenttypeid}/versions
createSCContentTypeVersion 1 param body → 200201422
GET
/structured-content/content-types/{content_type_id}/versions/{version_id}
GET /structured-content/content-types/{contenttypeid}/versions/{versionid}
getSCContentTypeVersion 2 params → 200422
POST
/structured-content/contents/{content_id}/migration
POST /structured-content/contents/{contentid}/migration
migrateSCContent 1 param body → 201400404409422
POST
/structured-content/contents/{content_id}/versions/{version_id}/previews/{preview_id}/acknowledge
POST /structured-content/contents/{contentid}/versions/{versionid}/previews/{previewid}/acknowledge
acknowledgeSCContentPreview 3 params body → 200422
POST
/structured-content/contents/{content_id}/versions/{version_id}/previews/{preview_id}/complete
POST /structured-content/contents/{contentid}/versions/{versionid}/previews/{previewid}/complete
completeSCContentPreview 3 params body → 200422
POST
/structured-content/content-types/{content_type_id}/managed-migrations
POST /structured-content/content-types/{contenttypeid}/managed-migrations
createSCContentTypeManagedMigration 1 param body → 200201400404
GET
/structured-content/content-types/{content_type_id}/managed-migrations
GET /structured-content/content-types/{contenttypeid}/managed-migrations
listSCContentTypeManagedMigrations 4 params → 200
POST
/structured-content/content-types/{content_type_id}/managed-migrations/{job_id}/start
POST /structured-content/content-types/{contenttypeid}/managed-migrations/{jobid}/start
startSCContentTypeManagedMigration 2 params → 200400404
GET
/structured-content/content-types/{content_type_id}/managed-migrations/{job_id}
GET /structured-content/content-types/{contenttypeid}/managed-migrations/{jobid}
getSCContentTypeManagedMigration 2 params → 200404
PATCH
/structured-content/content-types/{content_type_id}/managed-migrations/{job_id}
PATCH /structured-content/content-types/{contenttypeid}/managed-migrations/{jobid}
updateSCContentTypeManagedMigration 2 params body → 200422
DELETE
/structured-content/content-types/{content_type_id}/managed-migrations/{job_id}
DELETE /structured-content/content-types/{contenttypeid}/managed-migrations/{jobid}
deleteSCContentTypeManagedMigration 2 params → 204400404
POST
/structured-content/content-types/{content_type_id}/managed-migrations/validate
POST /structured-content/content-types/{contenttypeid}/managed-migrations/validate
validateSCContentTypeManagedMigration 1 param body → 200404

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are ContentDetailsModel (19 properties), VersionedContentTypeModel (15 properties), BaseContentTypeModel (14 properties), CoreFieldDef (13 properties). Each schema is shown below with its type and property counts.

SCContentTypeCreateRequest
object
7 properties 3 required
SCContentTypeCreateResponse
object
3 properties 1 required
AllowedContentTypeItem
object
2 properties 2 required
LocationDefaultValue
object
2 properties 2 required
ContentTypeFieldDefinition
object
6 properties 3 required
ContentFieldValueExpandedModel
object
5 properties 3 required
LibraryAssetType
string
An enumeration.
ContentTypeFieldEmbedMixConfig
integer
Ref Type: 1 Refer only 2 Refer and create embed 3 Create only
SCContentTypeManagedMigrationValidateRequest
object
2 properties 1 required
BaseFieldDefinitionType
string
An enumeration.
SCContentPreviewCompleteRequest
object
1 property 1 required
VersionedContentTypeModel
object
15 properties 9 required
ChoiceDisplayOption
string
An enumeration.
LocationFieldValueModel
object
3 properties 2 required
ContentTypeListingOption
string
List Type: 1 - Component only 2 - Content only 3 - Component and Content only
Error
object
Error payload
2 properties 1 required
SCContentPreviewAcknowledgeRequest
object
2 properties 2 required
NumberFieldValueModel
object
2 properties 1 required
SCContentTypeUpdateResponse
object
1 property 1 required
ContentFieldsVersionDetails
object
8 properties 5 required
DatetimeFieldDefinition
object
4 properties 3 required
SCContentTypeManagedMigrationStartResponse
object
2 properties
KeyedPreviewCompletedModel
object
5 properties 1 required
BaseFieldDefinition
object
3 properties 2 required
RichTextFieldDefinition
object
4 properties 2 required
KeyedPreviewErrorModel
object
5 properties 1 required
BaseContentTypeVersionModel
object
6 properties 6 required
CoreContentType
object
5 properties 2 required
NumberFieldDefinition
object
4 properties 1 required
TextFieldValueModel
object
2 properties 1 required
LibraryAssetFieldDefinition
object
3 properties 2 required
ContentMigrationSummary
object
5 properties
DatetimeFieldValueModel
object
2 properties 1 required
error_reason
string
An enumeration.
BooleanFieldValueModel
object
2 properties 1 required
URLFieldValueModel
object
2 properties 1 required
SCContentMigrationCreateRequest
object
5 properties 2 required
SCContentTypeManagedMigrationResponse
object
10 properties
ContentFieldsVersionValidation
object
1 property
ValidationError
object
3 properties 3 required
LocalizedFieldValues
object
2 properties 2 required
ChoiceFieldValueModel
object
2 properties 1 required
LibraryAssetFieldValueModel
object
4 properties 2 required
SCContentTypeVersion
ChoiceFieldDefinition
object
4 properties 2 required
BaseContentTypeModel
object
14 properties 8 required
CoreFieldDef
object
13 properties 5 required
HTTPValidationError
object
1 property
JSONFieldValueModel
object
2 properties 1 required
FieldType
string
An enumeration.
SCContentTypeVersionCreateRequest
object
3 properties 2 required
TextFieldDefinition
object
5 properties 3 required
SCContentType
ContentFieldValueModel
object
4 properties 2 required
SCContentTypeManagedMigrationCreateRequest
object
3 properties 2 required
RichTextFieldValueModel
object
2 properties 1 required
LibraryAssetDefaultValue
object
2 properties 2 required
SCContentTypeUpdateRequest
object
3 properties 2 required
ContentDetailsModel
object
19 properties 11 required
HTTPException
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

optimizely-structured-contents-api-openapi.yml Raw ↑

Other APIs Optimizely publishes across the network.

Optimizely Remote MCP Server — Experimentation
Optimizely Assets API
Optimizely Attributes API
Optimizely Audiences API
Optimizely Campaigns API
Optimizely Catalog Entries API
Optimizely Catalog Entry Relations API
Optimizely Catalog Nodes API
Optimizely Catalogs API
Optimizely Content API
Optimizely Content Types API
Optimizely Customers API
Where this information came from

This is an independent, third-party profile of Optimizely Structured Contents 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.