v1 > Services > CertificationsDelete

Delete or archive one or more certifications in Origin. Certification will be permanently deleted unless they are connected to the material of another company, in which case they will be archived.

  • URL

    /connect/v1/certifications/delete

    /connect/v1/async/certifications/delete

  • Method:

    POST

  • URL Params

    none

  • Request :

Field Type Required Description Domain of value
certifications[] array of object At least one The list of certifications to delete Certification object(s)
certifications[].originId string Only if no certifications[].externalId The certification unique origin ID Any string
certifications[].externalId string Only if no certifications[].originId The certification unique ID in your system Any string
  • Sample Request :
{
  "certifications":[
    {
      "originId":"13949a9b-ee17-4760-93e9-7749ff2faa79"
    }
  ]
}
  • Response :
Field Type Presence Description Domain of value
status object Always The execution status A status object
status.state string Always The state of execution 'SUCCESS' or 'ERROR'
status.code string On error The general error code and message See Errors reference
status.messages[] array of string On error List of error causes A validation message or other causes
result object On success The execution result A result object
result.entityType string On success The type of entity this result is about 'CERTIFICATION'
result.result object On success A simple completion message 'Delete completed.'
connectRequest object Always The exact request sent that produced this response A CertificationsDelete request

  • Sample Response (Success in sync mode):

    HTTP Code : 200

{
  "status":{
    "state":"SUCCESS"
  },
  "result":{
    "entityType":"CERTIFICATION",
    "result":"Delete completed."
  },
  "connectRequest":{
    "certifications":[
      {
        "originId":"13949a9b-ee17-4760-93e9-7749ff2faa79",
      }
    ]
  }
}
  • Response (async mode):
Field Type Presence Description Domain of value
status object Always The execution status A status object
status[].state string Always The state of execution 'SUCCESS' or 'ERROR'
status[].code string On error The general error code and message See Errors reference
status[].messages[] array of string On error List of error causes A validation message or other causes
result object On success The execution result A result object
result.poolingCallback string On success The URL callback to pool using the ResultGet endpoint A URL
connectRequest object Always The exact request you sent that produced this response A CertificationsCreate request

  • Sample Response (Success in async mode):

    HTTP Code : 200

{
  "status":{
    "state":"SUCCESS"
  },
  "result":{
    "poolingCallback":"https://origin.build/equinox/connect/v1/result/certifications_delete/batch/1c8a06b6-45be-4e68-9e2d-5c1f075e6ca2"
  },
  "connectRequest":{
    "certifications":[
      {
        "originId":"13949a9b-ee17-4760-93e9-7749ff2faa79"
      }
    ]
  }
}

  • Sample Response (Error):

    HTTP Code : 400, 500

{
  "status":{
    "state":"ERROR",
    "code":"CE00001 - Connect request failed validation. Refer to provided messages for details.",
    "messages":[
      "certifications[1] require one originId or externalId."
    ]
  },
  "connectRequest":{
    "certifications":[
      {
       "locale":"en"
      }
    ]
  }
}

results matching ""

    No results matching ""