Using the apps framework, you can build apps on top of the monday.com platform. These apps extend the platform's core functionality by bridging gaps and enabling you to customize your workflows.

Apps can be shared directly with select accounts, listed in the app marketplace for all monday.com users, or kept private within the account. They are created and managed in the Developer Center.

Queries

You can use the app query to retrieve app data via the API.

• Returns an object containing metadata about an app
• Can be queried directly at the root level or nested within a daily_analytics query

query {
  platform_api {
    daily_analytics {
      by_app {
        app {
          name
          features {
            type
            name
          }
          id
          api_app_id
          state
        }
        usage
      }
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($appId: ID!) { app (id: $appId) { features { id type } } }`;
const variables = {
  appId: 1234567890,
};
const response = await mondayApiClient.request(query, variables);

Arguments

You can use the following argument to reduce the number of results returned in your app query.

Fields

You can use the following fields to specify what information your app query will return. Some fields support their own subfields.

Mutations

You can create and update apps via the API using the following mutations.

Create app

The create_app mutation creates a new app via the API. You can specify which fields to return from the new app in the mutation response.

mutation {
  create_app(
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name.",
      kind: PUBLIC,
      permissions: ["docs:write", "me:read"]
    }
  ) {
    description
    name
    kind
    permissions
    collaborators {
      id
    }
  }
}

Arguments

You can use the following arguments to define the new app's characteristics.

Update app

The update_app mutation allows an app collaborator to update an app via the API. You can specify which fields to return from the updated app in the mutation response.

mutation {
  update_app(
    id: 123456,
    input: {
      collaborators: [54321, 12345],
      description: "The updated app description.",
      name: "The updated app name."
    }
  ) {
    description
    name
    collaborators {
      id
    }
  }
}	

Arguments

You can use the following arguments to define the app's updated characteristics.