Delete a custom activity (delete)

The delete Ortto endpoint of the activity entity is used to archive one or more custom activities in Ortto’s customer data platform (CDP).

Custom activities must be archived before they can be deleted. Once the activity has been archived via the API call, you can delete it in the Ortto app.

This page provides descriptions of this endpoint’s:


HTTP method and request resources

DELETE https://api.ap3api.com/v1/definitions/activity/delete

NOTE: Ortto customers who have their instance region set to Australia or Europe will need to use specific service endpoints relative to the region:

  • Australia: https://api.au.ap3api.com/
  • Europe: https://api.eu.ap3api.com/

For example: https://api.eu.ap3api.com/v1/<entity/endpoint>

All other Ortto users will use the default service endpoint (https://api.ap3api.com/).


Path and query parameters

This endpoint takes no additional path and/or query parameters.


Headers

This endpoint requires a custom API key and content type (application/json for the request body) in the header of the request:

  • X-Api-Key: CUSTOM-PRIVATE-API-KEY
  • Content-Type: application/json

Request body

The request body consists of a JSON object with the valid elements listed in the table below.

The following JSON object is an example of a request to archive a custom activity definition in your Ortto account’s CDP.

Example custom activity definition request body

json

{ "activity_field_id": "act:cm:act1" }

Valid request body elements

The following table lists all valid request body elements (arrays, objects, or fields), which are available to this endpoint.

Element

Type

Required

Description

activity_field_id

string

Required

The field ID for the custom activity. Learn more about Ortto’s ID format under Person fields.


Response payload

The response payload consists of a JSON object with the elements listed in the table below.

The following JSON object is an example of people’s data that Ortto retrieves from your Ortto account’s CDP after a request to this endpoint.

Example delete custom activity definition response payload from Ortto’s CDP

json

{ "archived_activity": "act:cm:act1" }

Response payload elements

The following table lists all elements (arrays, objects, or fields) in the response from a request to this endpoint.

Element

Type

Description

archived_activity

string

The ID of the custom activity that was archived.