Skip to main content

apps

Creates, updates, deletes, gets or lists an apps resource.

Overview

Nameapps
TypeResource
Iddigitalocean.addons.apps

Fields

The following fields are returned by SELECT queries:

The response will be a JSON object with a key called metadata. metadata will be an array of objects, each representing a metadata item for the app. Each object will contain details such as id, name, display_name, description, type, and options. For additional details specific to the app, find and view its DigitalOcean Marketplace page.

NameDatatypeDescription
idintegerUnique identifier for the addon metadata item. (title: id)
namestringThe name of the metadata item. (title: name, example: country_of_origin)
display_namestringThe display name of the metadata item. (title: display_name, example: Country of Origin)
descriptionstringA brief description of the metadata item. (title: description, example: Country for localization)
optionsarray (title: options)
typestringThe data type of the metadata value. (string, boolean) (title: type, example: string)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
addons_get_app_metadataselectapp_slugTo find out what metadata is required for a specific add-on, send a GET request to /v2/add-ons/apps/{app_slug}/metadata.
Metadata varies by application.
addons_get_appselectTo fetch details of all available Add-On Applications, send a GET request to /v2/add-ons/apps.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
app_slugstringThe slug identifier for the application whose metadata is being requested. (example: example_app)

SELECT examples

To find out what metadata is required for a specific add-on, send a GET request to /v2/add-ons/apps/{app_slug}/metadata.
Metadata varies by application.

SELECT
id,
name,
display_name,
description,
options,
type
FROM digitalocean.addons.apps
WHERE app_slug = '{{ app_slug }}' -- required
;