Skip to main content

ProjectTransfer

A request to move a listening project to another account: confirmed by the requester by email (1 hour), then accepted by an owner or admin of the target by email (7 days)

idstring<uuid>
statusstring

Possible values: [awaiting_confirmation, awaiting_acceptance, completed, cancelled, declined, expired, failed]

project object
idstring
namestring | nullnullable
from object
idinteger
namestring | nullnullable
typestring

Possible values: [personal, organization]

to object
idinteger
namestring | nullnullable
typestring

Possible values: [personal, organization]

requested_by object
idinteger
namestring | nullnullable
emailstring | nullnullable
sources_countinteger
mentions_countinteger
expires_at(string | null)<date-time>nullable

When the current step's link runs out; null once closed

confirm_expires_at(string | null)<date-time>nullable
accept_expires_at(string | null)<date-time>nullable
confirmed_at(string | null)<date-time>nullable
completed_at(string | null)<date-time>nullable
failure_reasonstring | nullnullable
created_atstring<date-time>
can object

What the caller may do now

confirmboolean
acceptboolean
declineboolean
cancelboolean
ProjectTransfer
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "awaiting_confirmation",
  "project": {
    "id": "string",
    "name": "string"
  },
  "from": {
    "id": 0,
    "name": "string",
    "type": "personal"
  },
  "to": {
    "id": 0,
    "name": "string",
    "type": "personal"
  },
  "requested_by": {
    "id": 0,
    "name": "string",
    "email": "string"
  },
  "sources_count": 0,
  "mentions_count": 0,
  "expires_at": "2024-07-29T15:51:28.071Z",
  "confirm_expires_at": "2024-07-29T15:51:28.071Z",
  "accept_expires_at": "2024-07-29T15:51:28.071Z",
  "confirmed_at": "2024-07-29T15:51:28.071Z",
  "completed_at": "2024-07-29T15:51:28.071Z",
  "failure_reason": "string",
  "created_at": "2024-07-29T15:51:28.071Z",
  "can": {
    "confirm": true,
    "accept": true,
    "decline": true,
    "cancel": true
  }
}