From 0f5e4c99691be0a3fb610a31fa6a78bb6b9e9fe5 Mon Sep 17 00:00:00 2001
From: Jacob Williamson <jacob.williamson@diamond.ac.uk>
Date: Wed, 19 Aug 2026 16:21:38 +0100
Subject: [PATCH] Update api docs

---
 docs/reference/rest_api.json | 73 ++++++++++++++++++++++++------------
 1 file changed, 50 insertions(+), 23 deletions(-)

diff --git a/docs/reference/rest_api.json b/docs/reference/rest_api.json
index c9d39c1..edeadbe 100644
--- a/docs/reference/rest_api.json
+++ b/docs/reference/rest_api.json
@@ -904,29 +904,9 @@
       "OIDCConfig": {
         "properties": {
           "well_known_url": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
+            "type": "string",
             "title": "Well Known Url",
-            "description": "URL to fetch OIDC config from the provider",
-            "deprecated": true
-          },
-          "issuer": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Issuer",
-            "description": "URL of OIDC provider"
+            "description": "URL to fetch OIDC config from the provider"
           },
           "client_id": {
             "type": "string",
@@ -949,6 +929,7 @@
         "additionalProperties": false,
         "type": "object",
         "required": [
+          "well_known_url",
           "client_id"
         ],
         "title": "OIDCConfig"
@@ -1226,6 +1207,16 @@
           },
           "kind": {
             "$ref": "#/components/schemas/TaskKind"
+          },
+          "user": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/User"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "type": "object",
@@ -1235,10 +1226,46 @@
           "status",
           "blueapi_calls",
           "position",
-          "kind"
+          "kind",
+          "user"
         ],
         "title": "TaskWithPosition"
       },
+      "User": {
+        "properties": {
+          "fedid": {
+            "type": "string",
+            "title": "Fedid"
+          },
+          "email": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Email"
+          },
+          "name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Name"
+          }
+        },
+        "type": "object",
+        "required": [
+          "fedid"
+        ],
+        "title": "User"
+      },
       "ValidationError": {
         "properties": {
           "loc": {