gln_revolut_delete_token

Declared in <galanthus/c_api/gln_capi.h>.

GLN_API gln_status_t GLN_CALL gln_revolut_delete_token(
    gln_backend_t* in_backend,
    int*           out_deleted_token_or_null,
    gln_error_t*   out_error);

Family: Revolut OAuth setup
Return type: gln_status_t

Purpose

Deletes persisted Revolut OAuth token state for an opened Revolut backend.

The call removes token blobs associated with the backend's configured token store and profile storage without destroying the backend or token-store handle.

Return

Returns GLN_OK on success and a non-OK gln_status_t value on failure.

Type	Nullability	Ownership
`gln_status_t`	value	value

Parameters

Name	Direction	Type	Nullability	Ownership
`in_backend`	input	`gln_backend_t*`	nonnull	borrowed
`out_deleted_token_or_null`	output	`int*`	nullable	caller_allocated_output
`out_error`	output	`gln_error_t*`	nullable	caller_allocated_output

Behavior

in_backend must be a Revolut backend opened with gln_open_revolut_backend.

out_deleted_token_or_null is optional. When supplied, it receives nonzero if any persisted token blob was removed and zero when no token blob was present.

Deleting token state removes the token-store blob and its sidecar key, but does not delete the token-store directory, state store, backend profile, or backend handle.

Redaction

The function reports only whether deletion occurred.

No token strings, key material, or authorization header values are returned.

Example

int deleted_token = 0;
gln_error_t error = {0};
gln_default_error(&error);
gln_status_t rc = gln_revolut_delete_token(backend, &deleted_token, &error);
if (rc == GLN_OK && deleted_token != 0) {
    note_token_state_removed();
}

gln_release_error(&error);