Remove a participant from dispatch by ref

1min

DELETE
API for removing a job from an existing dispatch: |  Header/Path   |   Description  |   Type    |

|---  |---  |---  |

|  X-COREOS-REQUEST-ID* (header)   | Unique request ID.    |   string  |
|  X-USER-ID* (header)   | User ID.    |   string  |
|  X-USER-NAME* (header)   | User name.    |   string  |
|  jobId* (path)   | Job ID.    |   string  |
|  dispatchId* (path)   | Dispatch ID.    |   string  |
*This is required.
HTTP Status Code Summary
CodeDescription
200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided.
404 - Not FoundThe requested resource doesn't exist.
Path Parameters
dispatchRef
DispatchRef
*
participantId
ParticipantId
*
Header Parameters
X-COREOS-REQUEST-ID
string
*
X-COREOS-TID
string
*
X-COREOS-ACCESS
string
*
X-COREOS-USERINFO
string
*
X-COREOS-CALLBACK-SECRET
string
Body Parameters
body
object
*
Description
Remove job from an existing dispatch
_event_meta
Meta
onRequest
CustomCallRequestObject
onError
CustomCallErrorObject
callback
CallbackObject
Responses
200
OK
SuccessResponse
error
Error
*
request
Request
*
data
object
400
Error Occurred
DeleteErrorResponse
error
Error
*
request
Request
*
401
Error Occurred
DeleteErrorResponse
error
Error
*
request
Request
*
404
Error Occurred
DeleteErrorResponse
error
Error
*
request
Request
*
Curl
JS
Ruby
Python
curl --location --globoff --request DELETE 'https://{domain}/core/api/v2/dispatch-service/dispatches/ref/{dispatchRef}/participants/{participantId}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "onRequest": {
    "url": "",
    "requestHeader": {},
    "requestBody": {},
    "method": "",
    "onResponse": {
      "wait": false
    }
  },
  "onError": {
    "url": "",
    "requestHeader": {},
    "requestBody": {},
    "method": "",
    "onResponse": {
      "wait": false
    }
  }
}'
curl --location --globoff --request DELETE 'https://{domain}/core/api/v2/dispatch-service/dispatches/ref/{dispatchRef}/participants/{participantId}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "onRequest": {
    "url": "",
    "requestHeader": {},
    "requestBody": {},
    "method": "",
    "onResponse": {
      "wait": false
    }
  },
  "onError": {
    "url": "",
    "requestHeader": {},
    "requestBody": {},
    "method": "",
    "onResponse": {
      "wait": false
    }
  }
}'
Responses
200
400
401
404
// OK 
{
  "error": {
    "code": "",
    "description": "",
    "additionalInfo": {}
  },
  "request": {
    "uri": "",
    "method": "",
    "queryString": "",
    "body": {}
  },
  "data": {
    "id": ""
  }
}
// OK 
{
  "error": {
    "code": "",
    "description": "",
    "additionalInfo": {}
  },
  "request": {
    "uri": "",
    "method": "",
    "queryString": "",
    "body": {}
  },
  "data": {
    "id": ""
  }
}
﻿
﻿

Code	Description
200 - OK	Everything worked as expected.
400 - Bad Request	The request was unacceptable, often due to missing a required parameter.
401 - Unauthorized	No valid API key provided.
404 - Not Found	The requested resource doesn't exist.

Updated 03 Aug 2023

Did this page help you?

Add multiple participants to a dispatch by ref

Update all the values of custom data for a dispatch by ref