Skip to main content
POST
Enhance Prompt
Use this API to check whether a prompt has enough detail for agent execution. It returns either a “sufficient” signal or a specific clarification request with suggested options. It does not modify the prompt; it only checks completeness.

Endpoint

POST https://api.velt.dev/v2/agents/prompt/enhance

Headers

x-velt-api-key
string
required
Your API key.
x-velt-auth-token
string
required

Body

Params

data
object
required

Example Requests

1. Simple prompt

2. With provider override and declared user context

Response

Success Response (prompt is sufficient)

When the prompt contains enough information, requirement is null:

Success Response (needs clarification)

Response fields:

Failure Response

Errors: INVALID_ARGUMENT (missing or empty prompt).