Renew an External Account Binding

Renew an External Account Binding by generating a new MAC key

Path parameters
name
string required

The name of the External Account Binding to renew

Body required
application/json

Renewal parameters

eabValidityDuration
string | null (FiniteDuration)
macKeyAlgorithm
string (ExternalAccountBindingAlgorithm)
Enum HS256 HS384 HS512
Responses
  • 200 External Account Binding successfully renewed
    _id
    string (Internal ID) required

    Object internal ID

    name
    string required
    status
    string (ExternalAccountBindingStatus) required

    The current status of the External Account Binding. See ExternalAccountBindingStatus for impact details.

    Enum valid disabled suspended deactivated compromised
    macKey
    string required

    The base64url-encoded MAC key of the External Account Binding. It is only returned in this response and cannot be retrieved afterwards.

    macKeyId
    string required

    The MAC key identifier of the External Account Binding. It is only returned in this response and cannot be retrieved afterwards.

    createdAt
    integer required
    eabPolicy
    string required
    allowedProfiles
    array of string required
    validationMethods
    array of string (AcmeAuthorizationType) required
    numberOfKeyRegeneration
    integer required
    macKeyAlgorithm
    string (ExternalAccountBindingAlgorithm) required
    Enum HS256 HS384 HS512
    description
    string
    identifierConstraint
    string
    emailConstraint
    string
    expirationDate
    integer
    compromisedAt
    integer

    The date when the EAB was compromised

    compromissionReason
    string (Revocation Reason)

    One of: unspecified, keycompromise, cacompromise, affiliationchange, superseded, cessationofoperation

  • 400 Invalid request
  • 401 Authentication error
  • 403 Forbidden action
  • 404 External Account Binding not found
    status
    integer required

    The http status code of the error. In compliance with RFC7807

    Value 404
    error
    string required

    The error code of the problem

    Value EAB-002
    message
    string required

    A short, human-readable summary of the problem type

    Value External Account Binding does not exist
    title
    string required

    A short, human-readable summary of the problem type. In compliance with RFC7807

    Value External Account Binding does not exist
    detail
    string | null

    A human-readable explanation specific to this occurrence of the problem. In compliance with RFC7807

  • 500 Unexpected internal server error