VocalDocscontracts 1.65.0

ToolSigningSecretState

The state of the Organization's tool signing secret (1.50.0): never the secret itself, which only a rotation answers.

An object with 7 fields.

Fields

FieldTypeRequiredDescription
created_atTimestamp or nullyesWhen the current secret was minted, by the api or a rotation; null when none exists.
existsbooleanyesWhether the Organization has a tool signing secret yet; the api mints the first when it first needs one (the first http Tool create, test or Call), so a new Organization has none.
object"tool_signing_secret"yes
previous_secret_expires_atTimestamp or nullyesWhen the previous secret stops signing, or null when none does.
previous_secret_hintstring or nullyesThe last four characters of the secret that keeps signing through the rotation window, or null when none does.
rotated_atTimestamp or nullyesWhen POST /v1/tool-signing-secret/rotate last rotated it; null when it was never rotated, so the current secret is the one the api minted and never showed.
secret_hintstring or nullyesThe last four characters of the current secret; null when none exists.

Used by

The operations whose parameters, request body or responses name this shape directly.