Compute Task API

Version: 0.0.2

Trigger an asynchronous execution of a task

POST

/compute/orgs/{org_id}/{topic}/{task}

Trigger an asynchronous task within a specific topic for a designated organization. The task, topic, and organization ID are supplied as path parameters. A JSON request body, referencing the ExecuteTaskRequest schema and containing task-specific parameters, is required for this operation. Upon successful start, a 303 response is returned. The URL of the status endpoint for the newly created job is indicated in the Location header of the response.

Request

Path parameters

org_iduuid

Required

The organization identifier

topicstring

Required

The compute topic

taskstring

Required

The compute task

Body parameters

parametersobject

Required

Example body

{
  "parameters": {}
}

Responses

303

303 response

401

Unauthorized

Response schema

statusinteger

typestring

titlestring

detailstring

Example response

{
  "status": 0,
  "type": "string",
  "title": "string",
  "detail": "string"
}

404

The specified resource was not found

Response schema

statusinteger

typestring

titlestring

detailstring

Example response

{
  "status": 0,
  "type": "string",
  "title": "string",
  "detail": "string"
}

422

Unauthorized

Response schema

statusinteger

typestring

titlestring

detailstring

Example response

{
  "status": 0,
  "type": "string",
  "title": "string",
  "detail": "string"
}

429

API gateway rate limit exceeded

Response schema

statusinteger

typestring

titlestring

detailstring

Example response

{
  "status": 0,
  "type": "string",
  "title": "string",
  "detail": "string"
}