Consider deprecating old services API

**Problem**
When working with api, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

Start by locating the services API and its error-handling entry points; the issue does not name files, tests, or commands. Clarify whether the intended outcome is deprecating the old API, improving error messages, or both, then define the affected behavior and validation before starting work.

Written by the indexing model from the issue text.