Description
Before using this endpoint, please review the OAuth2 authentication protocol and the purpose of each token by visiting: https://dru-id.com/developers/apis/oauth-2/.
To successfully invoke this service, a valid client_token associated with an authorized API client is required. Ensure that your application is properly registered and has been granted the necessary permissions to obtain and use this token.
Removes an existing typology from the system, provided it is not linked to any user, entry point, or assertion. Once a typology has been used for the first time, it must remain in the system to ensure data integrity and compliance.
Endpoint URL:
POST https://{your-endpoint-domain.com}/activityid/v1/typology/delete
Request Headers
| Parameter | Description | Type | Required |
|---|---|---|---|
| Authorization | “Bearer app_token” Literal text Bearer followed by app_token that is the token obtained from /oauth2/token endpoint | string | yes |
| Content-Type | The type of content that will be used for requests to be JSON | string | yes |
| Accept | The type of content that will be used for responses to be JSON | string | yes |
| From | Name of the entry point | string | yes |
| Accept-Language | Language for this request | Locale | no |
Query string parameters
None
Request Example
| Parameter | Description | Type | Required | Value |
|---|---|---|---|---|
| actor.id | app_id of the application you are using to log user | string | yes | app id |
| actor.objectType | Type of the object which represents the actor. | string | yes | ‘application’ |
| verb | Verb used for deleting the typology | string | yes | ‘delete’ |
| object.objectType | ObjectType represents the typology | string | yes | ‘typology’ |
| object.name | Name or key of the typology to be deleted. | string | yes | ‘My Typology’ |
| source.id | Type of device doing the activity | string | yes | ‘unknown’ | ‘pc’ | ‘mobile’ | ‘tablet’ | ‘game_console’ | ‘itv’ |
| source.objectType | Type of source | string | yes | ‘device’ |
Response examples
Response: Typology Deleted
| Parameter | Description | Type |
|---|---|---|
| result | Common http result | struct |
| result.status | Http code | integer |
Response codes
| Code | Type | Description |
|---|---|---|
| 400 | Error | Bad Request: The request could not be understood by the server due to malformed syntax |
| 401 | Error | Unauthorized: authentication is required and has failed or has not yet been provided (token is invalid, etc) |
| 404 | Error | Not Found: Typology to be deleted not found |
| 412 | Error | Precondition failed:It is not possible to delete a typology since it has some relations |
| 500 | Error | Internal Server Error: The server encountered an unexpected condition which prevented it from fulfilling the request |
| 504 | Error | Gateway TimeoutService can not contact with oauth server to do some internal operations |
| 204 | Success | Typology deleted successfully. (No content) |