PUT v1/Issue/{issueKey}

Update an Issue

Roles Allowed

admin, editor

Request Information

URI Parameters

NameDescriptionTypeAdditional information
issueKey

integer

Required

Body Parameters

IssueUpdate
NameDescriptionTypeAdditional information
CoverDisplayDate

A string showing exactly how the date is displayed on the cover

string

None.

IssueName

string

None.

Request Formats

application/json, text/json

Sample:
{
  "CoverDisplayDate": "sample string 1",
  "IssueName": "sample string 2"
}

application/xml, text/xml

Sample:
<IssueUpdate xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Bondi.Models.V3.ApiDto">
  <CoverDisplayDate>sample string 1</CoverDisplayDate>
  <IssueName>sample string 2</IssueName>
</IssueUpdate>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

HTTP 200 with the updated Paragraph if it is found, HTTP 404 if Paragraph is not found, HTTP 409 if validation fails

Issue
NameDescriptionTypeAdditional information
IssueKey

A unique key identifying the issue

integer

None.

IssueID

string

None.

CoverDate

A date object showing the date on the cover

date

None.

Volume

string

None.

IssueNumber

string

None.

IsLive

Controls whether or not the issue is visible to customers using the site (the issue is always visible to users on the admin site).

boolean

None.

GoLiveDate

The date this issue went live

date

None.

LastIndex

The last time this issue was indexed for searching

date

None.

GenreCounts

An Issue has multiple Articles. Each article has a Genre, such as 'Ad' or 'Article. GenreCount will give the number of articles of each genre for the issue. For example, an Issue might have 5 Ads and 8 Articles.

Collection of GenreCount

None.

Featured

Controls whether the issue is marked Featured

boolean

None.

Priority

Controls the priority in which the issue is displayed

integer

None.

IssueIdentifier

Issue GUID used for previewing issues

globally unique identifier

None.

CoverDisplayDate

A string showing exactly how the date is displayed on the cover

string

None.

IssueName

string

None.

Response Formats

application/json, text/json

Sample:
{
  "IssueKey": 1,
  "IssueID": "sample string 2",
  "CoverDate": "2024-10-31T09:54:06.8376254+00:00",
  "Volume": "sample string 4",
  "IssueNumber": "sample string 5",
  "IsLive": true,
  "GoLiveDate": "2024-10-31T09:54:06.8376254+00:00",
  "LastIndex": "2024-10-31T09:54:06.8376254+00:00",
  "GenreCounts": [
    {
      "Genre": "sample string 1",
      "Count": 2
    },
    {
      "Genre": "sample string 1",
      "Count": 2
    }
  ],
  "Featured": true,
  "Priority": 1,
  "IssueIdentifier": "deaf98c2-972d-4124-b570-0eaf77581054",
  "CoverDisplayDate": "sample string 8",
  "IssueName": "sample string 9"
}

application/xml, text/xml

Sample:
<Issue xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Bondi.Models.V3.ApiDto">
  <CoverDisplayDate>sample string 8</CoverDisplayDate>
  <IssueName>sample string 9</IssueName>
  <CoverDate>2024-10-31T09:54:06.8376254+00:00</CoverDate>
  <Featured>true</Featured>
  <GenreCounts>
    <GenreCount>
      <Count>2</Count>
      <Genre>sample string 1</Genre>
    </GenreCount>
    <GenreCount>
      <Count>2</Count>
      <Genre>sample string 1</Genre>
    </GenreCount>
  </GenreCounts>
  <GoLiveDate>2024-10-31T09:54:06.8376254+00:00</GoLiveDate>
  <IsLive>true</IsLive>
  <IssueID>sample string 2</IssueID>
  <IssueIdentifier>deaf98c2-972d-4124-b570-0eaf77581054</IssueIdentifier>
  <IssueKey>1</IssueKey>
  <IssueNumber>sample string 5</IssueNumber>
  <LastIndex>2024-10-31T09:54:06.8376254+00:00</LastIndex>
  <Priority>1</Priority>
  <Volume>sample string 4</Volume>
</Issue>