Create or partially update the marketplace listing

Creates or patches the marketplace listing for the application.

On first create, categoryId, nameEn and nameAr are required. Later
calls may send any subset of fields (partial PATCH merge).

Editable only while the listing is DRAFT, CHANGES_REQUESTED or REJECTED — an
already submitted/reviewed listing (IN_REVIEW / APPROVED / SCHEDULED /
PUBLISHED / UNPUBLISHED / SUSPENDED) returns 400.

The category must be active. When targetCountries is empty it defaults to
["SA"].

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[0-9]+$

Application ID (numeric string, stringified bigint)

Body Params
string

Target marketplace category ID (from the categories endpoint)

string
length ≤ 120

Listing display name (English)

string
length ≤ 120

Listing display name (Arabic)

string
length ≤ 2000

Listing description (English)

string
length ≤ 2000

Listing description (Arabic)

screenshots
array of strings

Screenshot URLs (legacy — superseded by marketplace cards, kept for reference)

screenshots
targetCountries
array of strings
Defaults to SA

ISO country codes the listing targets. Defaults to ["SA"] when omitted or empty.

targetCountries
Responses

400

Invalid category, or the listing is not editable in its status.

401

Missing or invalid developer-portal JWT.

404

Application not found or not owned by the developer.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json