Skip to main content
GET
/
api
/
v1
/
tasks
/
query
/
{taskId}
curl --request GET \
  --url https://api.ruxa.ai/api/v1/tasks/query/task_gemini-2.5-flash-image_1766304530229_cf4dafd2 \
  --header 'Authorization: Bearer sk-xxxxxx'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/image.png\"]}"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ruxa.ai/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to query the status and results of any async task created via the API.
In production, use the callback_url parameter to receive automatic notifications rather than polling.

​
Authorization

​
Authorization
string
required
Bearer Token authentication. Format: Bearer sk-xxxxxx

​
Path Parameters

​
taskId
string
required
Task ID, the unique identifier returned when creating the task

​
Response

​
code
integer
required
Response status code
​
message
string
required
Response message
​
data
object
required
Task data object

​
Task Status

StatusDescription
waitingTask queued for processing
queuingTask in processing queue
generatingTask is being processed
successTask completed successfully
failTask failed
curl --request GET \
  --url https://api.ruxa.ai/api/v1/tasks/query/task_gemini-2.5-flash-image_1766304530229_cf4dafd2 \
  --header 'Authorization: Bearer sk-xxxxxx'

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_1766304530229_cf4dafd2",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://cdn.example.com/image.png\"]}"
  }
}