Create Task

Create a task

post

Create a task. Only services can create tasks. Extesnions service will create a task for the extensions.

Body

application/json

idstringOptional

namestringOptional

iconstring · nullableOptional

revisioninteger · int32Optional

statusstring · enumOptionalPossible values:

codestringOptional

queuestringOptional

descriptionstringOptional

progressnumber · float · nullableOptional

etastring · date-time · nullableOptional

parametersany · nullableOptional

resultstring · nullableOptional

externalIdstring · nullableOptional

Responses

201

Created

application/json

400

Bad Request

application/json

post

/public/v1/system/tasks

HTTPcURLJavaScriptPython

POST /public/v1/system/tasks HTTP/1.1
Host: api.s1.show
Content-Type: application/json
Accept: */*
Content-Length: 374

{
  "name": "Transferring the buyer to a different account",
  "code": "platform.accounts.buyers.transfer",
  "queue": "marketplace/platform/internal/buyers/commands",
  "object": {
    "id": "BUY-1190-0394"
  },
  "description": "Transferring buyer 'BUY-1190-0394' to account 'ACC-5563-4382'",
  "parameters": {
    "BuyerId": "BUY-1190-0394",
    "TargetAccountId": "ACC-5563-4382"
  },
  "access": [
    {
      "id": "ACC-0000-0001"
    }
  ]
}

{
  "id": "TSK-0001-2474-4798-1266",
  "name": "Transferring the buyer to a different account",
  "revision": 1,
  "status": "Queued",
  "code": "accounts.buyers.transfer",
  "queue": "marketplace/platform/internal/buyers/commands",
  "object": {
    "id": "BUY-1190-0394"
  },
  "description": "Transferring buyer 'BUY-1190-0394' to account 'ACC-5563-4382'",
  "parameters": {
    "BuyerId": "BUY-1190-0394",
    "TargetAccountId": "ACC-5563-4382"
  },
  "access": [
    {
      "id": "ACC-0000-0001",
      "name": "SoftwareONE Operations"
    }
  ],
  "owner": {
    "id": "SVC-0001",
    "name": "platform"
  },
  "audit": {
    "created": {
      "at": "2026-02-02T12:00:00+00:00",
      "by": {
        "id": "SVC-0001",
        "name": "Platform"
      }
    },
    "updated": {
      "at": "2026-02-02T12:00:00+00:00",
      "by": {
        "id": "SVC-0001",
        "name": "Platform"
      }
    }
  }
}