deprecated
Idempotent

Create task

​

Deprecated — use POST /action-runs instead, which takes the same body and returns the same shape. Enqueue a one-off registry task.

Headers

  • x-corma-idempotency-key
    Type: string
    min length:  
    1

    Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Body·

required
application/json
  • actionIdentifier
    Type: string
    required

    The identifier of the action to trigger. Query the actions endpoint to get the list of available actions.

  • payload
    Type: object
    required

    The payload the action is triggered with. Must conform to the payloadSchema returned by actions for the chosen action.

    Properties: 1
  • connectorId
    Type: string

    The connector the action runs on: an identifier connectors returns, or the id of its connection. It must connect the integration of the action. Omitted, the action runs on the only connector of that integration.

Responses

  • 202
    Type:

    OK

    • actionIdentifier
      Type: string
      required

      The action that was triggered.

    • createdAt
      Type: stringFormat: date-time
      required

      The timestamp of when this resource was created. ISO 8601 format.

    • errorMessage
      Type: stringnullable
      required
    • id
      Type: integer
      min:  
      -9007199254740991
      max:  
      9007199254740991
      required

      Identifies the run. Pass it as actionRunId to fetch this run again.

    • payload
      Type: object
      required

      The payload the run was triggered with.

      Properties: 1
    • source
      Type: enum
      required

      What triggered the run. public_api is a run this API triggered; the log also covers runs triggered from the web app.

      values
      public_apiweb_appcopilot
    • status
      Type: enum
      required
      values
      ongoingcompletederrored
    • triggeredBy
      Type: nullable
      required
      Properties: 12
    • updatedAt
      Type: stringFormat: date-time
      required

      The timestamp of the last update to this resource. ISO 8601 format.

    Headers
    Headers: 1
    application/json
post/tasks
{
  "id": -9007199254740991,
  "status": "ongoing",
  "source": "public_api",
  "actionIdentifier": "string",
  "payload": {
    "additionalProperty": "anything"
  },
  "errorMessage": "string",
  "triggeredBy": {
    "id": "string",
    "type": "employee",
    "email": "string",
    "personalEmail": "string",
    "name": "string",
    "idpStatus": "active",
    "hrStatus": "active",
    "jobKey": "string",
    "countryCode": "string",
    "departmentKey": "string",
    "startDate": "2026-10-22T16:05:12.660Z",
    "terminationDate": "2026-10-22T16:05:12.660Z"
  },
  "createdAt": "2026-10-22T16:05:12.660Z",
  "updatedAt": "2026-10-22T16:05:12.660Z"
}

OK

Previous
Find task
Next
Registry actions