Skip to the content
Get an API key
  1. API reference
  2. Managed Transfers

Push destination token

PUT/public/transfer-sessions/{sessionUuid}/target-auth
Managed TransfersAuthBasicDevToken

Replaces the stored token of the session's destination account. The token must be for the same account. If a transfer of this session waits for the destination (user.auth_failed with preauthorized: true), it resumes.

Path parameters

sessionUuid
uuidrequired

The sessionUuid from Create transfer session

Request body

application/json · required

authData
PreauthorizedAuthData
required
authData.accessToken
string
requiredThe user's access token for your destination service.
authData.refreshToken
string
The refresh token. Used only when your destination integration has OAuth client credentials that can renew it.
authData.expiresAt
date-time | number
When the access token expires: an ISO 8601 date, or a Unix time in seconds or milliseconds.

Response

200application/json · PushTargetAuthResponseThe token is stored.
sessionUuid
uuid
target
PreauthorizedTarget
target.integrationType
string
target.integrationUserUuid
uuid
target.displayName
string | null
transferResumed
boolean
True when a transfer of this session waited for the destination and now continues.
Example answer
{
  "sessionUuid": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
  "target": {
    "integrationType": "spotify",
    "integrationUserUuid": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
    "displayName": "Jane Listener"
  },
  "transferResumed": true
}

Errors

400

The body is not valid.

401

The request has no credentials.

403

The credential is not secret, or the transfer service is not enabled for your account.

404

Your account has no session with this UUID.

409

The token is for another account, the session has no pre-authorized destination, or the session ended.

422

The music service refused the access token.

503

The music service could not be reached to check the token. Try again later.