Delete a stored response

DELETE

/responses/{response_id}

curl --request DELETE \
  --url https://api.katara.com/v1/responses/example \
  --header 'Authorization: Bearer <token>'

• Test and Live. The key decides which network a request is served on.

Deletes a stored response under the same rule as reading it.

Authorizations

• bearerAuth
• None

Parameters

Path Parameters

response_id

required

string

/^resp_[A-Za-z0-9_-]{1,120}$/

The id of a stored response.

Responses

200

The stored response was deleted.

Media typeapplication/json

object

id

required

string

object

required

string

Allowed value: response.deleted

deleted

required

boolean

Example

{
  "object": "response.deleted",
  "deleted": true
}

404

The response is missing, expired, deleted or someone else’s (response_not_found).

Media typeapplication/json

object

error

required

object

type

string

code

required

Stable error code.

string

message

required

Explanation for the caller.

string

param

string | null

Example^generated

{
  "error": {
    "type": "example",
    "code": "example",
    "message": "example",
    "param": "example"
  }
}