gln_wise_delete_token

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

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

Family: Wise token setup
Return type: gln_status_t

Purpose

Deletes persisted Wise token state for an opened Wise 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 Wise backend opened with gln_open_wise_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_wise_delete_token(backend, &deleted_token, &error);
if (rc == GLN_OK && deleted_token != 0) {
    note_token_state_removed();
}

gln_release_error(&error);