Skip to main content
GET
/
v1
/
requests
/
{id}
curl -X GET https://win.oneshotagent.com/v1/requests/req_xyz789 \
  -H "X-Agent-ID: 0x1234...5678"

{
  "request_id": "req_xyz789",
  "status": "pending",
  "tool": "email",
  "created_at": "2025-12-28T14:00:00Z",
  "updated_at": "2025-12-28T14:00:00Z"
}

​
Authentication

Requires X-Agent-ID header with your wallet address. You must be the owner of the job to access its status.

​
Path Parameters

​
id
string
required
The request ID returned from a tool invocation (e.g., req_xyz789)

​
Response

​
request_id
string
The job’s unique identifier
​
status
string
Current job status: pending, processing, completed, or failed
​
tool
string
The tool that was invoked (e.g., email, research)
​
result
object
Job result data (present when status is completed)
​
error
string
Error message (present when status is failed)
​
created_at
string
When the job was created
​
updated_at
string
When the job was last updated
​
email_tracking
object
Email-specific tracking data (for email jobs only)
curl -X GET https://win.oneshotagent.com/v1/requests/req_xyz789 \
  -H "X-Agent-ID: 0x1234...5678"

{
  "request_id": "req_xyz789",
  "status": "pending",
  "tool": "email",
  "created_at": "2025-12-28T14:00:00Z",
  "updated_at": "2025-12-28T14:00:00Z"
}

​
Notes

  • Jobs are retained for 30 days
  • You can only access jobs you own (verified by wallet address)
  • For async tools like email and research, poll this endpoint to get results