Tokens and Permissions

Share token

Use this call whenever you want to securely deliver a token to someone. The link to the token retrieval page will be sent to the provided email address. The link will expire in 2 hours.

Master tokens and protected-branch tokens cannot be shared; other tokens can be shared only by their creator or the creator's admin.

Deprecated: this endpoint will be removed. To get a token value again, use POST /v2/storage/tokens/{id}/refresh. Note that refreshing generates a new token value and the current value becomes immediately invalid, so every existing user of the token has to be updated.

post/v2/storage/tokens/{id}/share

Request

Path parameters

idinteger required

Token ID.

Request body

recipientEmailstring email required

Recipient's email address.

messagestring nullable

Message for the token recipient. Must not contain links or web addresses.

Example request

{
  "recipientEmail": "martin@keboola.com",
  "message": "Hi"
}

Response

Token shared, the email was sent.

Changes

No recorded changes to this operation across all 1 revision of this API.