API Reference

Update a section item

put
https://your-marketplace.partnerfleet.app/admin_api/v2/listings//section_items/

Changes one item of a listing's content section. Only the fields you send change; fields that belong to other sections are ignored, and a request with none of the section's fields returns 422. On an active listing, the change is saved to the partner's draft version: you can pass the item ID from the active listing and it is matched to the same item in the draft. If the item cannot be found or matched, the response is 422 and lists the draft's current items and their IDs. Requires the listings_update permission.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

Listing ID.

int32
required

ID of the item, as returned by GET /listings/{id}.

Body Params

Update a section item

string
enum
required

Section the item belongs to.

string

Item title (features, benefits, services, next_steps, resources, pricing_editions); the person's job title (testimonials, team_members); or the section title (description_sections: an existing description section with this title is used, otherwise a new one is created).

string

Body text (features, benefits, services, next_steps, resources). Returned as plain text.

string

faqs: the question.

string

faqs: the answer. Returned as plain text.

string

The person's name (testimonials, team_members), or the row label (details).

string

testimonials: the quote.

string

team_members: a short biography.

string

Link URL (resources, testimonials, team_members, details).

string

resources: label of the link.

string

team_members: label of the link.

string

description_sections: the section body, as HTML.

string

details: name of the template's additional-details section the row belongs to (one of detail_sections in GET /listings/template_schema).

string

Public http or https URL of the item's image (features, benefits, services, next_steps, resources, testimonials, screenshots). PartnerFleet downloads the image.

string

team_members: public http or https URL of the headshot image. PartnerFleet downloads the image.

string

screenshots: alternative text of the image.

string

screenshots: Image for a picture or Video for a hosted video.

string

screenshots: URL of the video when image_type is Video. YouTube, Vimeo, Wistia, Vidyard and Brightcove are supported.

string

pricing_editions: the plan description.

string

pricing_editions: the price as displayed, for example $49.

string

pricing_editions: billing period or qualifier shown with the price, for example per month.

string

pricing_editions: text of the plan's call-to-action button.

string

pricing_editions: URL the plan's call-to-action button opens.

features
array of strings

pricing_editions: the plan's headline features.

features
boolean

pricing_editions: whether the plan offers a free trial.

string

properties: the property label. An existing property with this name is used, otherwise a new one is created.

string

properties: the property value.

string

properties: Whitepaper, External URL or Detail.

int32

Position of the item within its section. Not used by description_sections and details.

Responses

Updated 2 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago

Did this page help you?