Requests

Get a background or idempotent request

GET
/v1/requests/{id}

The state of a request made with Prefer: respond-async or an Idempotency-Key. While status is running, response is null; when done, response holds the status and body the call would have returned. Only the API key that made the request can read it. Kept 24 hours.

Scope: any

Authorization

apiKey
headerAuthorizationBearer <ik_live_…>

An organisation API key from Settings → Organisation → API keys. Each operation names the one scope it needs — see https://developer.ingenee.ai/docs/authentication.

Path Parameters

id*string

Response Body

OK

application/json
  1. response
id*string
Formatuuid
operation*string
status*string
Value in"running""done"
createdAt*string
Formatdate-time
completedAt*|
Formatdate-time
response*|null
Example Request
curl -X GET 'https://dev.app.ingenee.ai/api/v1/requests/string'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "operation": "generateSchedule",  "status": "running",  "createdAt": "2019-08-24T14:15:22Z",  "completedAt": "2019-08-24T14:15:22Z",  "response": {    "status": 0,    "body": null  }}