Features

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 app query
query {
  app(id:123456) {
    features(limit:2) {
      created_at
      data
      id
      name
    }
  }
}

Arguments

ArgumentTypeDescription
limitIntThe number of features to return. The default is 25.
pageIntThe page number to return. Starts at 1.

Fields

FieldTypeDescription
app_idIDThe unique identifier of the app the feature belongs to.
created_atDateThe app feature's creation date.
dataJSONThe app feature's data.
idID!The app feature's unique identifier.
nameStringThe app's feature's name.
typeStringThe app feature's type.
updated_atDateThe 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

ArgumentTypeDescription
app_idID!The app's unique identifier to create the new feature for.
app_version_idIDThe unique identifier of the app version to create the new feature for.
dataJSONThe app feature's data.
deploymentAppFeatureReleaseInputThe new app feature's deployment data.
nameStringThe new app feature's name.
slugString!The new app feature's unique slug.
typeAppFeatureTypeE!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

ArgumentTypeDescription
idID!The app feature's unique identifier.
inputUpdateAppFeatureInput!The input for the updated app feature.