Segments API

Update segment

The following fields can be modified through this endpoint: <br><b>name, description, definition, owner, dataview ID, aamStatus</b><br><br>Note: "aamStatus" is used to "publish" a report suite segment to other products in the Experience Cloud. Description is always required when publishing with aamStatus. The report suite must already be pre-configured for AAM for publishing to succeed (see the "/segments/aamStatus/" endpoint for more information). <br>Format for aamStatus object:<br>"aamStatus":{"published":["rsid1","rsid2"]}<br><br>Example "defintion" for use in testing API below ("Page exists"):<br>"definition":{"func":"segment","container":{"func":"container","context":"hits","pred":{"func":"exists","description":"Page","val":{"func":"attr","name":"variables/page"}}},"version":[1,0,0]}<br><br>Response will be the newly modified segment object after the update request completes.<br><br><b><span style="text-decoration: underline;">SegmentResponse</span></b><br>A segment response will always include these default items:<br><b>id</b><br><br>Other attributes can be optionally requested through the 'expansion' field: <br><b>name</b>: Name of the segment<br><b>description</b>: Description of the segment<br><b>dataId</b>: Associated data ID of the segment<br><b>owner</b>: Owner of the segment<br><b>modified</b>: Date that the segment was last modified (ISO 8601)<br><b>definition</b>: Segment definition as JSON object<br><b>compatibility</b>: Products that the segment is compatible with<br><b>isDeleted</b>: Returns whether or not the segment is 'Deleted' (note that deleted segments are only returned if requested by ID)

put/segments/{id}

Request

  • Base URL: https://cja.adobe.io
  • URL: https://cja.adobe.io/segments/{id}
  • Auth: none declared. Required headers: Authorization, x-api-key, x-gw-ims-org-id

Path parameters

idstring required

Segment ID to be updated

Query parameters

expansionstring[]

Comma-delimited list of additional segment metadata fields to include on response.

localestring

Locale

cachedtrue | false

Use cached results

Headers

Authorizationstring required

The access token copied from your CJA API client integration, prefixed with "Bearer ". For more information on how to obtain this value, see Getting started with the CJA API.

x-api-keystring required

The API key copied from your CJA API client integration. For more information on how to obtain this value, see Getting started with the CJA API.

x-gw-ims-org-idstring required

The Organization ID copied from your CJA API client integration. For more information on how to obtain this value, see Getting started with the CJA API.

Request body

namestring
descriptionstring
modifiedstring date-time
report_suitestring
modifiedByIdstring
definitionobject
compatibilityobject
createDatestring date-time
createdBystring
disabledboolean
internalboolean
organizationstring
templateboolean
recentRecordedAccessstring date-time
performanceScorestring
performanceScoreWeightVersionstring
idstring
definitionLastModifiedstring date-time
dataIdstring
isDeletedboolean
dataNamestring
tagsobject[]
sharesobject[]
approvedboolean
favoriteboolean
usageSummaryobject

Response

Successful operation

namestring
descriptionstring
modifiedstring date-time
report_suitestring
modifiedByIdstring
definitionobject
compatibilityobject
createDatestring date-time
createdBystring
disabledboolean
internalboolean
organizationstring
templateboolean
recentRecordedAccessstring date-time
performanceScorestring
performanceScoreWeightVersionstring
idstring
definitionLastModifiedstring date-time
dataIdstring
isDeletedboolean
dataNamestring
tagsobject[]
sharesobject[]
approvedboolean
favoriteboolean
usageSummaryobject

Changes

No recorded changes to this operation across all 30 revisions of this API.