I am editing some metadata via themoviedb.org site but the changes are not fully reflected in API.

I have changed episode name in PAW Patrol S09E31 from "31. epizoda" to "Tlapky zachraňují nadýchaného starostu".

Then the API for whole season 9 https://api.themoviedb.org/3/tv/57532/season/9 returns the updated name

{
      "air_date": "2023-02-10",
      "episode_number": 30,
      "episode_type": "standard",
      "id": 4104758,
      "name": "Tlapky zachraňují Alexovy opeřené přátele",
      "overview": "",
      "production_code": "923",
      "runtime": 12,
      "season_number": 9,
      "show_id": 57532,
      "still_path": "/8fSWW1ky8ZpuZG63wlpzGsDgKVi.jpg",
      "vote_average": 10,
      "vote_count": 1,
      "crew": [
        {
          "job": "Writer",
          "department": "Writing",
          "credit_id": "6658e0db44c59f97be74ed4c",
          "adult": false,
          "gender": 0,
          "id": 4745423,
          "known_for_department": "Writing",
          "name": "Clark Stubbs",
          "original_name": "Clark Stubbs",
          "popularity": 0.1553,
          "profile_path": null
        }
      ],
      "guest_stars": []
    }

but the API for specific episode https://api.themoviedb.org/3/tv/57532/season/9/episode/31 returns the old name

{
  "air_date": "2023-02-10",
  "crew": [
    {
      "job": "Writer",
      "department": "Writing",
      "credit_id": "6658c9ea8e42e6dc246c2a6a",
      "adult": false,
      "gender": 0,
      "id": 1245500,
      "known_for_department": "Writing",
      "name": "Sean Jara",
      "original_name": "Sean Jara",
      "popularity": 0.1452,
      "profile_path": null
    }
  ],
  "episode_number": 31,
  "guest_stars": [],
  "name": "31. epizoda",
  "overview": "",
  "id": 4241249,
  "production_code": "923",
  "runtime": 12,
  "season_number": 9,
  "still_path": "/lrBTwNq6xB1jFEKY1Yk3nRagmWI.jpg",
  "vote_average": 0,
  "vote_count": 0
}

After many hours of investigation where the problem is I just also found out that the API has some 8h delay as someone posts here frequently. However I see this specific example as a bug - the database is inconsistent.

Also I highly recommend to update the documentation with this well known API delay (eg. https://developer.themoviedb.org/docs/faq). You could also add info about the temporary inconsistency if that is not a bug but a side effect of some caches. Some people (including myself) might just want to fix / update some metadata info for their API clients. When people see the change immediately updated on the web they are using, they naturally expect it to be also updated via the API. You will save many headaches and hours of investigation where the problem actually is. Even better to inform users right after the save that the update might take long time to propagate into their software connected to tmdb.