Learn how to read, create, update, and delete app features using the platform API
All apps built on the monday.com apps framework are comprised of features. These features determine where the app appears in the UI, the methods required to build it, and its functionality. They are created and managed through the Developer Center.
Queries
Get features
- Returns an object containing metadata about an app's features
- Must be nested within an
appquery
query {
app(id:123456) {
features(limit:2) {
created_at
data
id
name
}
}
}Arguments
| Argument | Type | Description |
|---|---|---|
| limit | Int | The number of features to return. The default is 25. |
| page | Int | The page number to return. Starts at 1. |
Fields
| Field | Type | Description |
|---|---|---|
| app_id | ID | The unique identifier of the app the feature belongs to. |
| created_at | Date | The app feature's creation date. |
| data | JSON | The app feature's data. |
| id | ID! | The app feature's unique identifier. |
| name | String | The app's feature's name. |
| type | String | The app feature's type. |
| updated_at | Date | The app feature's last updated date. |
Mutations
Create app feature
Creates an app feature. Returns AppFeatureType.
mutation {
create_app_feature(
slug: "test-item-view",
app_id: 9876543210,
type: ITEM_VIEW
) {
id
name
}
}Arguments
| Argument | Type | Description |
|---|---|---|
| app_id | ID! | The app's unique identifier to create the new feature for. |
| app_version_id | ID | The unique identifier of the app version to create the new feature for. |
| data | JSON | The app feature's data. |
| deployment | AppFeatureReleaseInput | The new app feature's deployment data. |
| name | String | The new app feature's name. |
| slug | String! | The new app feature's unique slug. |
| type | AppFeatureTypeE! | The new app feature's type. |
Update app feature
Updates an app feature. Returns AppFeatureType.
mutation {
update_app_feature(
id: 12345,
input: {
data: {
name: "Updated App Feature",
description: "This is an updated app feature description."
}
deployment: {
kind: CLIENT_SIDE_CODE,
data: {
url: "/sub-route"
}
}
}
) {
id
name
data
}
}Arguments
| Argument | Type | Description |
|---|---|---|
| id | ID! | The app feature's unique identifier. |
| input | UpdateAppFeatureInput! | The input for the updated app feature. |
