connection
Confirm a key authenticates and return the workspace it belongs to. Records verification, not usage.
Requires no scope — any valid key can verify itself. Stamps api_keys.verified_at and emits mcp_connection_verified; deliberately does NOT touch last_used_at or emit api_call, so checking a key can never make it look like an agent used it. Prefer this over calling a data endpoint to test credentials.
post/api/v1/connection/verify
Response
OK — the key authenticates; returns { ok, workspaceId, name, scopes }
object required