feat: bump docs to latest version of api spec and add changelog (#924)

* feat: bump docs to latest version of api spec and add changelog

* fix: add changelog generation prompt

* fix links

one has to be added manually

* fix

* fix

* fix override

* fix placement

* fix: add v1 voices to legacy section

* fix fmt

* fix to list voices v2

Author: AngeloGiacco

.github/scripts/check_links.py

@@ -553,6 +553,8 @@ def validate_links(docs_dir, valid_paths, api_reference_paths):
 
     special_case_paths = {
         "/docs/conversational-ai/api-reference/conversational-ai/websocket",
+        "/docs/api-reference/phone-numbers/twilio-outbound-call",
+        "/docs/api-reference/phone-numbers/create-phone-number"
     } #todo angelo: fix code so we can remove this 
     valid_paths.update(special_case_paths)
 

changelog-prompt.txt

@@ -0,0 +1,12 @@
+you are a world class developer experience engineer, tasked with writing a technical changelog update.
+
+please create a new changelog entry in the same style as the others @2025-03-17.md @2025-03-10.md based on the following information, the docs pages of the endpoints are defined in  @docs.yml. 
+
+here are the api spec updates. 
+
+[openapi diff]
+
+here are the summaries of the PRs to add 
+
+[PRs to add]
+

fern/apis/api/openapi-overrides.yml

@@ -235,9 +235,13 @@ paths:
       parameters:
         - {} # public_user_id
         - description: ID of the voice to be used. You can use the [Get voices](/docs/api-reference/voices/get-all) endpoint list all the available voices.
+  /v2/voices:
+    get:
+      summary: List voices
   /v1/voices:
     get:
       summary: List voices
+      deprecated: true
   /v1/voice-generation/generate-voice/parameters:
     get:
       x-fern-ignore: true
@@ -446,6 +450,10 @@ paths:
     get:
       x-fern-audiences:
         - convai
+  /v1/convai/twilio/outbound_call:
+    post:
+      x-fern-audiences:
+        - convai
   /v1/convai/knowledge-base:
     get:
       x-fern-audiences: