diff --git a/docs/api-reference/auth/create-api-key.mdx b/docs/api-reference/auth/create-api-key.mdx
index 0af8655c6..81ca87cea 100644
--- a/docs/api-reference/auth/create-api-key.mdx
+++ b/docs/api-reference/auth/create-api-key.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: post /auth/generate-apikey
+openapi: post /auth/api_keys
 ---
\ No newline at end of file
diff --git a/docs/api-reference/auth/retrieve-api-keys.mdx b/docs/api-reference/auth/retrieve-api-keys.mdx
index c7f77c41f..b2eb07b14 100644
--- a/docs/api-reference/auth/retrieve-api-keys.mdx
+++ b/docs/api-reference/auth/retrieve-api-keys.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /auth/api-keys
+openapi: get /auth/api_keys
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/define-target-field.mdx b/docs/api-reference/field-mapping/define-target-field.mdx
index 8d8865426..bdfb21640 100644
--- a/docs/api-reference/field-mapping/define-target-field.mdx
+++ b/docs/api-reference/field-mapping/define-target-field.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: post /field-mapping/define
+openapi: post /field_mappings/definitions
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/map-custom-field.mdx b/docs/api-reference/field-mapping/map-custom-field.mdx
index fd441dc25..a28cd6b59 100644
--- a/docs/api-reference/field-mapping/map-custom-field.mdx
+++ b/docs/api-reference/field-mapping/map-custom-field.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: post /field-mapping/map
+openapi: post /field_mappings/mappings
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/retrieve-custom-properties.mdx b/docs/api-reference/field-mapping/retrieve-custom-properties.mdx
index 5818fad0c..f3fa70f32 100644
--- a/docs/api-reference/field-mapping/retrieve-custom-properties.mdx
+++ b/docs/api-reference/field-mapping/retrieve-custom-properties.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /field-mapping/properties
+openapi: get /field_mappings/properties
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/retrieve-field-mapping-entities.mdx b/docs/api-reference/field-mapping/retrieve-field-mapping-entities.mdx
index 10302409f..b626df997 100644
--- a/docs/api-reference/field-mapping/retrieve-field-mapping-entities.mdx
+++ b/docs/api-reference/field-mapping/retrieve-field-mapping-entities.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /field-mapping/entities
+openapi: get /field_mappings/entities
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/retrieve-field-mappings-values.mdx b/docs/api-reference/field-mapping/retrieve-field-mappings-values.mdx
index 14ffc5da3..ba2604ef6 100644
--- a/docs/api-reference/field-mapping/retrieve-field-mappings-values.mdx
+++ b/docs/api-reference/field-mapping/retrieve-field-mappings-values.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /field-mapping/value
+openapi: get /field_mappings/values
 ---
\ No newline at end of file
diff --git a/docs/api-reference/field-mapping/retrieve-field-mappings.mdx b/docs/api-reference/field-mapping/retrieve-field-mappings.mdx
index 9c359d295..0207d6500 100644
--- a/docs/api-reference/field-mapping/retrieve-field-mappings.mdx
+++ b/docs/api-reference/field-mapping/retrieve-field-mappings.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /field-mapping/attribute
+openapi: get /field_mappings/attributes
 ---
\ No newline at end of file
diff --git a/docs/api-reference/magic-link/retrieve-magic-links.mdx b/docs/api-reference/magic-link/retrieve-magic-links.mdx
index bff5d87f6..f236ae3c2 100644
--- a/docs/api-reference/magic-link/retrieve-magic-links.mdx
+++ b/docs/api-reference/magic-link/retrieve-magic-links.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: get /magic-link
+openapi: get /magic_links
 ---
\ No newline at end of file
diff --git a/docs/api-reference/projects/create-a-project.mdx b/docs/api-reference/projects/create-a-project.mdx
index c222dcfd4..b836fca6f 100644
--- a/docs/api-reference/projects/create-a-project.mdx
+++ b/docs/api-reference/projects/create-a-project.mdx
@@ -1,3 +1,3 @@
 ---
-openapi: post /projects/create
+openapi: post /projects
 ---
\ No newline at end of file
diff --git a/docs/core-concepts/custom-fields.mdx b/docs/core-concepts/custom-fields.mdx
index 6ea8dad80..01f478cde 100644
--- a/docs/core-concepts/custom-fields.mdx
+++ b/docs/core-concepts/custom-fields.mdx
@@ -56,7 +56,7 @@ The following example creates a custom field mapping in two steps (**define and
 
 ```shell Create custom field
 curl --request POST \
-         --url https://api.panora.dev/field-mappings \
+         --url https://api.panora.dev/field_mappings \
          --header 'Authorization: Bearer <MY_API_KEY>' \
          --header 'Content-Type: application/json' \
          --data '{
@@ -76,7 +76,7 @@ The following example creates a custom field mapping in two steps (**define and
         <CodeGroup>
         ```shell Define custom field
         curl --request POST \
-             --url https://api.panora.dev/field-mappings/define \
+             --url https://api.panora.dev/field_mappings/definitions \
              --header 'Authorization: Bearer <MY_API_KEY>' \
              --header 'Content-Type: application/json' \
              --data '{
@@ -89,7 +89,7 @@ The following example creates a custom field mapping in two steps (**define and
 
         ```shell Map custom field
         curl --request POST \
-             --url https://api.panora.dev/field-mappings/map \
+             --url https://api.panora.dev/field_mappings/mappings \
              --header 'Authorization: Bearer <MY_API_KEY>' \
              --header 'Content-Type: application/json' \
              --data '{