Placewise API

Update Redirection

PUT

https://api.mpc.dev.placewise.com/v1/content/management/redirections/{id}

API Permit:Cms:Api:Management:Redirections:Update

API Context:Customer

Authorizations:UserToken

Request

Path Params

integer

required

ID of the record

>= 1

Example:

3004

Query Params

dry_run

boolean

optional

When true, the request doesn't persist record on success

Header Params

Content-Type

enum<string>

required

Details

Allowed value:

application/json

Default:

application/json

X-User-Agent

string

required

Arbitrary identifier of your client. Details

Default:

X-Product-Name

string

required

API Product for API context. Details

Default:

X-Loyalty-Club-Slug

string

required

LoyaltyClub for API context. Details

Default:

X-Customer

string

required

Customer for API context. Details

Default:

Authorization

string

required

Member or User Authorization.

Default:

Bearer {{_OAUTH_TOKEN}}

X-Client-Authorization

string

optional

Default:

Body Params application/json

article

object (Article)

required

locales

required

products

required

status

enum<string>

required

Determines visibility in Public API

Allowed values:

draftpublishedunpublished

Example:

published

visible_since

required

visible_until

required

visible_in_list

boolean

required

Should record be returned on lists of CMS Public API

Default:

true

Example:

true

topic_relevant_until

required

Date until the topic of article is "relevant" to users

sorting_priority

integer

required

Priority of the record during sorting in CMS Public API. Currently read-only.

Example:

title

required

slug

required

teaser

required

body

required

headline

required

published_at

required

Article's publication date presented in CMS Public API. By default, visible_since is returned

image

required

Must be uploaded as a file of type: cms_article_image

url

string

required

Address of the entity page on website

Example:

path/to/:id

prototype_id

required

ContentPrototype that serves as a master for this record. Manually it can be only unset

external_master

string

required

When present, the record is being synced from given external source

Example:

scraper

us_legacy_data

object | null

required

tag_ids

required

archived_at

required

Example

{
    "article": {
        "locales": [
            "en"
        ],
        "products": [
            "website"
        ],
        "status": "draft",
        "visible_since": "2022-11-09T16:25:58.099512Z",
        "visible_until": "2022-11-15T16:25:58.099512Z",
        "visible_in_list": true,
        "topic_relevant_until": "2022-11-09T16:25:58.099512Z",
        "sorting_priority": 0,
        "title": {
            "en": "Text"
        },
        "slug": {
            "en": "Text"
        },
        "teaser": {
            "en": "Text"
        },
        "body": {
            "en": "Text"
        },
        "headline": {
            "en": "Text"
        },
        "published_at": "2022-11-09T16:25:58.099512Z",
        "url": "path/to/:id",
        "external_master": "scraper",
        "us_legacy_data": {},
        "tag_ids": [
            1
        ]
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.mpc.dev.placewise.com/v1/content/management/redirections/3004?dry_run=' \
--header 'X-User-Agent;' \
--header 'X-Product-Name;' \
--header 'X-Loyalty-Club-Slug;' \
--header 'X-Customer;' \
--header 'Authorization;' \
--header 'X-Client-Authorization: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "article": {
        "locales": [
            "en"
        ],
        "products": [
            "website"
        ],
        "status": "draft",
        "visible_since": "2022-11-09T16:25:58.099512Z",
        "visible_until": "2022-11-15T16:25:58.099512Z",
        "visible_in_list": true,
        "topic_relevant_until": "2022-11-09T16:25:58.099512Z",
        "sorting_priority": 0,
        "title": {
            "en": "Text"
        },
        "slug": {
            "en": "Text"
        },
        "teaser": {
            "en": "Text"
        },
        "body": {
            "en": "Text"
        },
        "headline": {
            "en": "Text"
        },
        "published_at": "2022-11-09T16:25:58.099512Z",
        "url": "path/to/:id",
        "external_master": "scraper",
        "us_legacy_data": {},
        "tag_ids": [
            1
        ]
    }
}'

Responses

🟢200Success

application/json

Body

redirection

object (Redirection)

required

integer <uint64>

read-onlyrequired

Example:

locales

required

products

required

status

enum<string>

required

Determines visibility in Public API

Allowed values:

draftpublishedunpublished

Example:

published

visible_since

required

visible_until

required

created_at

string <date-time>

read-onlyrequired

Time of record creation

Example:

2022-11-05T16:25:58.099512Z

updated_at

string <date-time>

read-onlyrequired

Time of the last record update

Example:

2022-11-15T16:25:58.099512Z

archived_at

required

Example

{
    "redirection": {
        "id": 1,
        "locales": [
            "en"
        ],
        "products": [
            "website"
        ],
        "status": "draft",
        "visible_since": "2022-11-09T16:25:58.099512Z",
        "visible_until": "2022-11-15T16:25:58.099512Z",
        "created_at": "2022-11-05T16:25:58.099512Z",
        "updated_at": "2022-11-15T16:25:58.099512Z",
        "archived_at": "2022-11-15T16:25:58.099512Z"
    }
}

🟠404Record Not Found

🟠422Invalid Parameters

Modified at 2025-05-29 15:21:08

Create Redirection

Archive Redirection