Undo an import

POST

/v1/imports/{id}/undo

curl --request POST \
  --url https://api.threadkite.app/v1/imports/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/undo \
  --header 'Authorization: Bearer <token>'

• Threadkite API

Removes every message, note and event the import stored, the threads it made (unless they have had new messages since, which stay with those) and the contacts it made once they have no threads. Companies it linked stay. This cannot be reversed; import again to bring the history back.

Authorizations

• api_key
  imports:write

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

Media typeapplication/json

A batch of history brought in from another system

object

id

required

string format: uuid

source

required

string

name

required

string

status

required

open takes more threads; undone has had what it made removed

string

Allowed values: open undone

tag

required

object

id

required

string format: uuid

name

required

string

threadsCreated

required

integer

>= -9007199254740991 <= 9007199254740991

threadsUpdated

required

Threads already in Threadkite that it added history to

integer

>= -9007199254740991 <= 9007199254740991

contactsCreated

required

integer

>= -9007199254740991 <= 9007199254740991

messagesImported

required

Messages, notes and events stored

integer

>= -9007199254740991 <= 9007199254740991

createdAt

required

string format: date-time

undoneAt

required

string format: date-time

nullable

Example

{
  "source": "pipedrive",
  "status": "open"
}

401

Missing or invalid API key

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

errors

With code invalid: every problem with the request, by field (message is the first)

Array<object>

object

path

required

Dotted path inside the item, e.g. attributes.price.amountMinor

string

message

required

string

Example

{
  "statusCode": 403,
  "code": "forbidden",
  "message": "You do not have permission to do that.",
  "errors": [
    {
      "message": "Enter the make"
    }
  ]
}

402

The organisation is on the Free plan (code upgrade_required)

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

feature

required

The feature that needs Pro

string

nullable

Allowed values: extraSeats connections aiAssistant aiReplies rules fullReports api inboxes bulkMessages videoMessages

upgradePath

required

Where to upgrade or pay, in the web app

string

Example

{
  "statusCode": 402,
  "code": "upgrade_required",
  "message": "Connections are part of Pro. Upgrade to connect texts, calls and more.",
  "feature": "extraSeats",
  "upgradePath": "/settings/billing"
}

403

The key does not have the scope (or the person the permission)

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

errors

With code invalid: every problem with the request, by field (message is the first)

Array<object>

object

path

required

Dotted path inside the item, e.g. attributes.price.amountMinor

string

message

required

string

Example

{
  "statusCode": 403,
  "code": "forbidden",
  "message": "You do not have permission to do that.",
  "errors": [
    {
      "message": "Enter the make"
    }
  ]
}

404

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

errors

With code invalid: every problem with the request, by field (message is the first)

Array<object>

object

path

required

Dotted path inside the item, e.g. attributes.price.amountMinor

string

message

required

string

Example

{
  "statusCode": 403,
  "code": "forbidden",
  "message": "You do not have permission to do that.",
  "errors": [
    {
      "message": "Enter the make"
    }
  ]
}

409

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

errors

With code invalid: every problem with the request, by field (message is the first)

Array<object>

object

path

required

Dotted path inside the item, e.g. attributes.price.amountMinor

string

message

required

string

Example

{
  "statusCode": 403,
  "code": "forbidden",
  "message": "You do not have permission to do that.",
  "errors": [
    {
      "message": "Enter the make"
    }
  ]
}

429

Rate limit reached

Media typeapplication/json

object

statusCode

required

number

code

required

Stable machine-readable reason

string

message

required

string

retryAfter

required

Seconds until another request will be accepted

number

Example

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Each key can make 120 requests a minute; try again in 12 seconds.",
  "retryAfter": 12
}