---
title: "Set Tokenise Destination"
method: PATCH
path: "/v2/credentials/{credential_id}/tokenise-destination"
tags: ["Credentials v2"]
---

# Set Tokenise Destination

`PATCH /v2/credentials/{credential_id}/tokenise-destination`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/credentials/{credential_id}/tokenise-destination`
- Auth: HTTP bearer

Set where a connected channel's imported history tokenises.

Imported channel history has no workspace — nothing is downloaded, so there
is no container — and registration refuses until a destination exists
(content_routes.register_content_for_revenue, 409
`tokenise_destination_unset`). This is the only thing that clears that
refusal, and the last gate before a permanent on-chain allocation, so every
fact is checked HERE rather than assumed from the client having rendered a
filtered list of teams.

Changing a destination applies FORWARD ONLY. Content already registered
carries its own copy of the destination it was minted under
(`contents_v2.tokenise_destination_mode` / `tokenise_team_id`), and
`resolve_registration_destination` reads that copy in preference to the
credential. Nothing here touches contents_v2 — that copy is the record, and
the split derived from it is already on-chain.

## Path parameters

- `credential_id` string, required

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Request body

- SetTokeniseDestinationRequest: Where this channel's imported history tokenises. Exactly one of the two. `solo` is an explicit flag rather than "team_id omitted" on purpose: omission is what "never chose" looks like, and if absence meant solo, a client that forgot the field would commit the user to a permanent 100%-to-me mint without anyone deciding that.
  - `team_id` string, nullable: Team to tokenise this channel's imports under.
  - `solo` boolean: Set true to tokenise solo. Mutually exclusive with team_id.

## Response `200`

Successful Response

- CredentialResponse: Full credential response (without sensitive token data). Tokens are NEVER exposed - only metadata about the credential.
  - `credential_id` string, required
  - `profile_id` string, required
  - `platform` string, required
  - `account_name` string, required
  - `account_username` string, nullable, required
  - `account_id` string, required
  - `nickname` string, nullable, required
  - `account_label` string, nullable
  - `display_name` string, required: Best display name (nickname > account_name > account_username)
  - `status` string, required
  - `is_active` boolean, required
  - `needs_reauth` boolean, required
  - `token_expires_at` string, date-time, nullable, required
  - `has_refresh_token` boolean, required
  - `token_valid` boolean, nullable: Result of live token validation against the platform API. None if not checked.
  - `last_checked_at` string, date-time, nullable
  - `last_check_source` string, nullable
  - `last_check_outcome` string, nullable: alive | dead | undetermined
  - `last_check_detail` string, nullable
  - `tokenise_destination_set` boolean: True once a destination has been chosen for this channel.
  - `tokenise_team_id` string, nullable: Team the channel's imports tokenise to; null for solo.
  - `tokenise_destination_mode` string, nullable: 'team', 'solo', or null when no destination has been set.
  - `facebook_page_id` string, nullable
  - `facebook_page_name` string, nullable
  - `facebook_pages` FacebookPageSummary[], nullable
    - `page_id` string, required
    - `name` string, required
  - `granted_scopes` string[], nullable
  - `reconnect_required` object, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable, required
  - `last_used_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)