docs(api): sync nav + error codes with openapi drift fixes

api-reference/error-codes.mdx

@@ -148,7 +148,7 @@ Load-shedding on a saturated API instance — back off and retry.
 | `UZ-AGT-006` | 409 | Agent name already exists | Name taken. Kill the existing agent first, then re-install. |
 | `UZ-AGT-008` | 400 | Invalid agent config | `TRIGGER.md` config_json fails schema validation. Verify trigger, tools, credentials, and budget fields. |
 | `UZ-AGT-009` | 404 | Agent not found | No agent with this ID in the workspace. |
-| `UZ-AGT-010` | 409 | Agent already stopped or killed | This agent is already stopped or killed. Re-install before issuing another stop. |
+| `UZ-AGT-010` | 409 | Agent state transition not allowed | The requested lifecycle action is not valid from the agent's current state. The response detail names the specific transition that was refused. |
 | `UZ-AGT-011` | 400 | SKILL.md and TRIGGER.md disagree on `name:` | Top-level `name:` must match across both files. One identity per agent bundle. |
 | `UZ-AGT-012` | 409 | Agent is paused | Agent is not active and refuses new work. Resume with `agentsfleet resume <agent>`, then retry. |
 
@@ -157,6 +157,7 @@ Load-shedding on a saturated API instance — back off and retry.
 | Code | HTTP | Title | Common Causes |
 |---|---|---|---|
 | `UZ-GRANT-001` | 403 | No integration grant for service | This agent has no approved grant for the target service. Request one with `POST /v1/agents/{id}/integration-requests`. |
+| `UZ-GRANT-002` | 404 | Integration grant not found | No grant with that id exists for this agent, or it was already revoked. List current grants with `GET /v1/workspaces/{workspace_id}/agents/{agent_id}/integration-grants`. |
 
 ## Approval gate
 

docs.json

@@ -113,7 +113,12 @@
             "group": "Authentication",
             "pages": [
               "POST /v1/auth/sessions",
-              "GET /v1/auth/sessions/{session_id}"
+              "GET /v1/auth/sessions/{session_id}",
+              "PATCH /v1/auth/sessions/{session_id}/approve",
+              "POST /v1/auth/sessions/{session_id}/verify",
+              "DELETE /v1/auth/sessions/{session_id}",
+              "DELETE /v1/auth/sessions/all",
+              "POST /v1/auth/identity-events/clerk"
             ]
           },
           {
@@ -143,7 +148,23 @@
             "group": "Billing",
             "pages": [
               "GET /v1/tenants/me/billing",
-              "GET /v1/tenants/me/billing/charges"
+              "GET /v1/tenants/me/billing/charges",
+              "GET /v1/tenants/me/billing/charges/{event_id}/telemetry"
+            ]
+          },
+          {
+            "group": "Fleet",
+            "pages": [
+              "POST /v1/runners",
+              "GET /v1/fleet/runners",
+              "PATCH /v1/fleet/runners/{id}",
+              "GET /v1/fleet/runners/{id}/events"
+            ]
+          },
+          {
+            "group": "Model Catalogue",
+            "pages": [
+              "GET /_um/da5b6b3810543fe108d816ee972e4ff8/cap.json"
             ]
           },
           {