Hello to everyone,
I don’t understand if the api 2025-01 are officially released.
On
seems that 2025-01 is the current one.
So i downloaded the sdl at the link
https://api.monday.com/v2/get_schema?version=2025-01&format=sdl
but in the schema i didn’t find the new mutations, for example
create_team or delete_team
described at this link
Someone can please give me a hint?
I don’t understand what’s wrong.
Thank you
Davide
Could a moderator kindly answer the question?
Thanks
Davide
Not a mod, but create_team and delete_team are both in the current API docs:
Did you test out the mutations in an app yet? If something is in the API reference above, it should work.
Sometimes bits of the docs lag a little bit.
yeah the SDL schema is bad, its not generated programatically - and appears to contain other errors.
There are plenty of tools that can create an SDL from an introspection JSON though. If you even need to create the SDL. If you’re using TS/JS and are looking for the schema for purposes of autocomplete with the LSP then something like below works.
import { fileURLToPath } from "node:url";
import { dirname, resolve } from "node:path";
import { config as initEnv } from "dotenv";
import type { IGraphQLConfig } from "graphql-config";
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
initEnv({ path: resolve(__dirname, ".env.local") });
const config: IGraphQLConfig = {
projects: {
monday: {
schema: [
{
"https://api.monday.com/v2/": {
headers: {
Authorization: process.env.MONDAY_ACCESS_TOKEN as string,
},
},
},
],
documents: ["packages/**/*.{ts,mts,js,mjs,jsx,tsx,graphql}"],
},
},
};
export { config as defaultGraphQLConfig };
export default config;
Or if you want to use codegen to create Typescript types for example:
import type { CodegenConfig } from "@graphql-codegen/cli";
import { config as initEnv } from "dotenv";
import { fileURLToPath } from "node:url";
import { dirname, resolve } from "node:path";
const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);
initEnv({ path: resolve(__dirname, ".env.local") });
const config: CodegenConfig = {
schema: [
{
"https://api.monday.com/v2/": {
headers: {
Authorization: process.env.MONDAY_ACCESS_TOKEN as string,
},
},
},
],
generates: {
"./src/types/monday-api-stable.ts": {
plugins: ["typescript"],
},
},
};
export default config;
You can update the headers to include the API-Version as well and get them specifically. You could also use any other codegen plugins to generate things you might need.
Hi All
API version 2025-01 is released and contains all mentioned features.
The get_schema endpoint is currently missing some things added in 2024-10 and above.
As Cody mentioned in the thread, if you need the SDL running an introspection query and converting the results is currently the best work around.
Some details:
We do generate the schema programmatically! However, since version 2024-10 we moved to a federated API architecture, a process in which we stitch multiple subgraphs into a single supergraph. The get_schema endpoint is not currently fetching the entire graph, and thus some endpoints are missing.
The team is working to fix this issue as quickly as possible!
Happy coding
Thanks for you support.
It’s very annoying that the schema SDL or JSON are not updated.
I have double checked and as you’re saying in the playground there are 3 options for the schema, directly related to the get_schema api. I tried them with postman too.
I don’t understand but … ok
I would say, set your tooling up to use the introspection query, and then you’re set. Plus, then you’re not reliant on downloaded schema files - you’ll always be up to date.
Out of curiosity what are you using the schema for?
