Credentials v2

Revalidate Credential Endpoint

Ask the platform whether the STORED credential still works, whatever status says, and act on the answer. This is what the Reconnect button calls.

THREE OUTCOMES: alive the platform accepted the stored credential. Status is active again, the auth notification is cleared. No form. dead the platform answered 401. Status is needs_reauth; needs_input says what the creator must now supply (for Mux only the secret — the Token ID is account_id). undetermined the platform could not be asked (timeout, 5xx, 429, no probe). NOTHING changed except the evidence stamp; the caller may simply try again.

Why this exists: the health endpoint below refused non-active rows, the list endpoint's token_valid returned False before decrypting, and the sweep skipped flagged rows — so a needs_reauth written by a refresher that never contacted the platform could never be disproved. Loading the credential regardless of status is the whole point.

post/v2/credentials/{credential_id}/revalidate

Request

  • Base URL
    https://api.jubjubapp.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

credential_idstring required

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Response

Successful Response

credential_idstring required
platformstring required
account_idstring required

Platform identifier; the Token ID for Mux.

outcomestring required

alive | dead | undetermined

statusstring required

Credential status AFTER this check.

detailstring required
checked_atstring date-time nullable required
needs_inputstring[]

What a reconnect must ask the creator for when dead. Mux: token_secret. Vimeo: token. Vimeo OTT: api_key. OAuth: oauth (a consent redirect). Empty when alive or undetermined.

reasonstring nullable

Why: token_invalid (the only reason that means reconnect), missing_permission (the login works; the app lacks a permission, which a reconnect cannot fix), temporary, request_error, unknown. None when alive.

Changes

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