Skip to content

Update app listing

PUT/marketplace/apps/{id}

Updates an existing app listing's metadata such as name, description, category, or version. Status changes (publish/suspend) require separate approval or admin action.

Request

Path parameters

NameTypeRequiredDescription
idintegerYes

The numeric ID of the app to update.

Request body

Content type application/json (required).

FieldTypeRequiredDescription
namestringYes

Max length: 255

slugstringYes

URL-safe unique identifier — lowercase letters, numbers, and hyphens only.

Max length: 80

categorystringYes

Max length: 80

descriptionstringNo

Max length: 2000

developerstringNo

Max length: 255

versionstringNo

Initial version string in semver format (e.g. "1.0.0").

Max length: 30

homepage_urlstring (uri)No
support_emailstring (email)No

Example

{
  "description": "Now also supports Slack Connect channels.",
  "version": "2.2.0"
}

Responses

200 App listing updated

404 App not found

Example request

curl -X PUT "https://{tenant}.faciotech.net/api/v1/marketplace/apps/{id}" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"description": "Now also supports Slack Connect channels.", "version": "2.2.0"}'
Loading