PATCH /tasks/{task_id}/structured-contents/{content_id}

1 min

PATCH

https://api.cmp.optimizely.com/v3/tasks/{task_id}/structured-contents/{content_id}

Experimental Update structured content using a task.

Path Parameters

task_idstringrequired
Example
da80cfd7bbf84959a8a981acbad996b3
Description
Unique identifier of the task
content_idstringrequired
Example
da80cfd7bbf84959a8a981acbad996b3
Description
Unique identifier of the structured content

Body Parameters

bodyTaskStructuredContentUpdateRequestrequired
Description
Payload to update structured content
- titlestring
  Example
  Some webpage
  Description
  Title of the structured content
- primary_localestring
  Example
  en_US
  Description
  The primary locale of the content
- expiredboolean
  Description
  Expired status of the content
- expiry_datetimestring<date-time>
  Example
  2019-10-07T13:15:30Z
  Description
  Date and time on which the content will expire, in ISO 8601 UTC format
  Format
  date-time
- sourcestring
  Description
  Source of the content
- source_idstring
  Description
  Source id of the content
- source_metadatastring
  Description
  Source metadata of the content
- fieldsStructuredContentFields
  Description
  The fields of structured content

Responses

200Updated structured content as response

ContentDetailsModel
- titlestringrequired
  Description
  Title of the content
- primary_localestring
  Example
  en_US
  Description
  The primary locale of the content
- expiredboolean
  Description
  Expired status of the content
- sourcestring
  Description
  Source of the content
- root_contentbooleanrequired
  Description
  This is true when the content is not embedded in another content through a content type reference field
- template_guidstring
  Description
  Template GUID of the content
- expiry_datetimestring<date-time>
  Description
  Date and time on which the content will expire, in ISO 8601 UTC format
  Format
  date-time
- source_idstring
  Description
  Source ID of the content
- source_metadatastring
  Description
  Source metadata of the content
- latest_fields_versionContentFieldsVersionDetailsrequired
  - fieldsmap<string, LocalizedFieldValues[]>required
    Description
    List of fields
  - validationContentFieldsVersionValidation
    - fieldsmap<string, object>
      Description
      Validation for the fields
  - created_bystringrequired
    Description
    Unique identifier of the user who created the version
  - source_idstring
    Description
    Source ID of the version
  - source_metadatastring
    Description
    Source metadata of the version
  - created_atstring<date-time>required
    Description
    Date and time on which the version was created, in ISO 8601 UTC format
    Format
    date-time
  - version_guidstringrequired
    Description
    Unique identifier of the version
  - content_hashstringrequired
    Description
    Content hash of the version
- content_guidstringrequired
  Description
  Unique identifier of the content
- created_bystringrequired
  Description
  Unique identifier of the user who created the content
- updated_bystringrequired
  Description
  Unique identifier of the user who last updated the content
- created_atstring<date-time>required
  Description
  Date and time on which the content was created, in ISO 8601 UTC format
  Format
  date-time
- updated_atstring<date-time>required
  Description
  Date and time on which the content was last updated, in ISO 8601 UTC format
  Format
  date-time
- content_type_guidstringrequired
  Description
  Unique identifier of the content type
- content_type_namestringrequired
  Description
  Name of the content type
- content_typeVersionedContentTypeModel
  - namestringrequired
    Description
    Name of the content type
  - descriptionstring
    Description
    Description of the content type
  - componentbooleanrequired
    Description
    Indicates whether the content type is a component
  - disabledboolean
    Description
    Disabled status of the content type
  - sourcestring
    Description
    Source of the content type
  - versionSCContentTypeVersionrequired
    - BaseContentTypeVersionModel
      - latestbooleanrequired
        Description
        Indicates whether the version is the latest
      - version_guidstringrequired
        Description
        Unique identifier of the version
      - created_bystringrequired
        Description
        Unique identifier of the user who created the version
      - created_atstring<date-time>required
        Description
        Date and time on which the version was created, in ISO 8601 UTC format
        Format
        date-time
      - expected_localesstring[]required
        Description
        Expected locales of the version
      - linksobjectrequired
        Description
        Meta links
        selfstring
        Example
        https://api.cmp.optimizely.com/v3/structured-content/content-types/555876bf63e94ea4b3ec4da318736414/versions/31a6d15b09c54a04935203eb958ae058
        Description
        URL of the content type version
        content_typestring
        Example
        https://api.cmp.optimizely.com/v3/structured-content/content-types/555876bf63e94ea4b3ec4da318736414
        Description
        URL of the content type
    - object
      - field_definitionsNumberFieldDefinition[]required
        coreCoreFieldDefrequired
        keystringrequired
        Description
        Key of the field
        namestringrequired
        Description
        Name of the field
        is_listbooleanrequired
        Description
        Indicates whether the field is a list
        is_requiredbooleanrequired
        Description
        Required status of the field
        need_internationalizationbooleanrequired
        Description
        Indicates whether the field needs internationalization
        min_list_lengthinteger
        Description
        Minimum length of the list
        max_list_lengthinteger
        Description
        Maximum length of the list
        field_typeFieldType
        Description
        An enumeration.
        Max depth limit reached
        source_idstring
        Description
        Source ID of the field
        source_metadatastring
        Description
        Source metadata of the field
        order_indexinteger
        Description
        Order index of the field
        help_textstring
        Description
        Helptext of the field
        editor_metadataobject
        Description
        Editor metadata of the field
        min_valuenumber
        Description
        Minimum value of the field
        max_valuenumber
        Description
        Maximum value of the field
        default_valuesnumber[]
        Description
        Default values of the field
  - thumbnail_guidstring
    Description
    Thumbnail GUID of the content type
  - content_type_guidstringrequired
    Description
    Unique identifier of the content type
  - created_bystringrequired
    Description
    Unique identifier of the user who created the content type
  - updated_bystringrequired
    Description
    Unique identifier of the user who last updated the content type
  - created_atstring<date-time>required
    Description
    Date and time on which the content type was created, in ISO 8601 UTC format
    Format
    date-time
  - updated_atstring<date-time>required
    Description
    Date and time on which the content type was last updated, in ISO 8601 UTC format
    Format
    date-time
  - source_idstring
    Description
    Source of the content type
  - source_metadatastring
    Description
    Source metadata of the content type
  - linksobjectrequired
    Description
    Meta links
    - selfstring
      Example
      https://api.cmp.optimizely.com/v3/structured-content/content-types/9fda53cf66a14fd487251480ca695c7b
      Description
      URL of the content type
    - versionsstring
      Example
      https://api.cmp.optimizely.com/v3/structured-content/content-types/9fda53cf66a14fd487251480ca695c7b/versions
      Description
      URL of the content type versions
- linksobjectrequired
  Description
  Meta links
  - selfstring
    Example
    https://api.cmp.optimizely.com/v3/structured-content/contents/a24b834428a043ab8caed1ded4606f7d
    Description
    URL of the content
  - definitionstring
    Example
    https://api.cmp.optimizely.com/v3/structured-content/content-types/5291e00b990a49f1857adc024fd26620/versions/a8b48d529701452aa56a4e752e1b0ffc
    Description
    URL of the content definition

400Client error

Error
Example
```
{
  "message": "Unsupported arguments: a,b,c"
}
```
Description
Error payload
- messagestringrequired
  Example
  Not found
  Description
  Message describing the error
- errorsmap<string, string>
  Description
  Additional information

401Authorization error

Error
Example
```
{
  "message": "Unauthorized"
}
```
Description
Error payload
- messagestringrequired
  Example
  Not found
  Description
  Message describing the error
- errorsmap<string, string>
  Description
  Additional information

403Permission error

Error
Example
```
{
  "message": "You do not have the permission to perform this operation"
}
```
Description
Error payload
- messagestringrequired
  Example
  Not found
  Description
  Message describing the error
- errorsmap<string, string>
  Description
  Additional information

404Not found error

Error
Example
```
{
  "message": "Resource not found"
}
```
Description
Error payload
- messagestringrequired
  Example
  Not found
  Description
  Message describing the error
- errorsmap<string, string>
  Description
  Additional information

422Unprocessable entity error

Error
Example
```
{
  "message": "Resource cannot be processed"
}
```
Description
Error payload
- messagestringrequired
  Example
  Not found
  Description
  Message describing the error
- errorsmap<string, string>
  Description
  Additional information

curl

curl --request PATCH \
     --url https://api.cmp.optimizely.com/v3/tasks/{task_id}/structured-contents/{content_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.cmp.optimizely.com/v3/tasks/{task_id}/structured-contents/{content_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.cmp.optimizely.com/v3/tasks/{task_id}/structured-contents/{content_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.cmp.optimizely.com/v3/tasks/{task_id}/structured-contents/{content_id}"

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

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

print(response.text)

200

// Updated structured content as response
{
  "title": "",
  "primary_locale": "en_US",
  "expired": false,
  "source": "",
  "root_content": false,
  "template_guid": "",
  "expiry_datetime": "",
  "source_id": "",
  "source_metadata": "",
  "latest_fields_version": {
    "fields": "",
    "validation": {
      "fields": ""
    },
    "created_by": "",
    "source_id": "",
    "source_metadata": "",
    "created_at": "",
    "version_guid": "",
    "content_hash": ""
  },
  "content_guid": "",
  "created_by": "",
  "updated_by": "",
  "created_at": "",
  "updated_at": "",
  "content_type_guid": "",
  "content_type_name": "",
  "content_type": {
    "name": "",
    "description": "",
    "component": false,
    "disabled": false,
    "source": "",
    "version": {},
    "thumbnail_guid": "",
    "content_type_guid": "",
    "created_by": "",
    "updated_by": "",
    "created_at": "",
    "updated_at": "",
    "source_id": "",
    "source_metadata": "",
    "links": {
      "self": "https://api.cmp.optimizely.com/v3/structured-content/content-types/9fda53cf66a14fd487251480ca695c7b",
      "versions": "https://api.cmp.optimizely.com/v3/structured-content/content-types/9fda53cf66a14fd487251480ca695c7b/versions"
    }
  },
  "links": {
    "self": "https://api.cmp.optimizely.com/v3/structured-content/contents/a24b834428a043ab8caed1ded4606f7d",
    "definition": "https://api.cmp.optimizely.com/v3/structured-content/content-types/5291e00b990a49f1857adc024fd26620/versions/a8b48d529701452aa56a4e752e1b0ffc"
  }
}

400

// Client error
{
  "message": "Not found",
  "errors": ""
}

401

// Authorization error
{
  "message": "Not found",
  "errors": ""
}

403

// Permission error
{
  "message": "Not found",
  "errors": ""
}

404

// Not found error
{
  "message": "Not found",
  "errors": ""
}

422

// Unprocessable entity error
{
  "message": "Not found",
  "errors": ""
}