diff --git a/spec/API_specification/linear_algebra_functions.md b/spec/API_specification/linear_algebra_functions.md
index 100efccf2..54f66699b 100644
--- a/spec/API_specification/linear_algebra_functions.md
+++ b/spec/API_specification/linear_algebra_functions.md
@@ -279,6 +279,23 @@ TODO
 
 TODO
 
+(function-linalg-svdvals)=
+### linalg.svdvals(x, /)
+
+Computes the singular values of a matrix (or a stack of matrices) `x`.
+
+#### Parameters
+
+-   **x**: _<array>_
+
+    -   input array having shape `(..., M, N)` and whose innermost two dimensions form matrices on which to perform singular value decomposition. Should have a floating-point data type.
+
+#### Returns
+
+-   **out**: _Union\[ <array>, Tuple\[ <array>, ... ] ]_
+
+    -   an array with shape `(..., K)` that contains the vector(s) of singular values of length `K`. For each vector, the singular values must be sorted in descending order by magnitude, such that `s[..., 0]` is the largest value, `s[..., 1]` is the second largest value, et cetera. The first `x.ndim-2` dimensions must have the same shape as those of the input `x`. The returned array must have the same floating-point data type as `x`.
+
 (function-trace)=
 ### trace(x, /, *, axis1=0, axis2=1, offset=0)