# Create a temporary signing link

Generate a one-hour link for one party to access one or more already processed EviSigns owned by the caller. Single-item methods: MobilePin, EmailPin, Handwriting, WebClick. Multiple-item flow accepts MobilePin, EmailPin or WebClick with compatible commitment and geolocation settings; delivery subdomains, reject reasons and signature questions are not supported. The whole request fails if all items are discarded or the allowed count is exceeded. Lite Flow is incompatible with handwriting, geolocation, BeforeDoc/End signing steps or a configured SignedRedirectUrl. Treat the returned URL as sensitive and opaque. JSON and legacy XML are supported; the guide documents XML names and negotiation.

Endpoint: POST /EviSign/SignLink
Version: 1.0
Security: basicAuth

## Security:

  - `basicAuth` (unknown)
    http basic

## Request fields (application/json):

  - `UniqueIds` (array, required)
    EviSign identifiers. A configured maximum defaults to 25; duplicate input identifiers count towards the limit.

  - `Party` (string, required)
    Email address or phone number of exactly one signer or reviewer per included EviSign.

  - `Attributes` (array)
    Only ReturnUrl is supported. Each key must occur once.

  - `Attributes.Key` (string, required)
    Enum: "ReturnUrl"

  - `Attributes.Value` (string, required)
    Absolute HTTP(S) redirect URL. uniqueId and accepted query parameters are added after the party finishes.

  - `Attributes.Values` (array)
    Legacy contract member; ignored. Omit it.

  - `DiscardedThreshold` (integer)
    Maximum count of discarded EviSigns, not a percentage. At least one valid item must remain.

  - `LiteFlow` (boolean)
    Single-item flow only. True requests Lite Flow; false forces standard flow; omitted uses delivery configuration. Ignored for multiple valid items.

  - `Language` (string)
    Case-sensitive language for multiple-item flow. Validated but not applied for single-item flow.
    Enum: "ca", "de", "en", "es", "fr", "it", "pt", "pt-BR", "ro", "el"

## Response 200:

  - `200` (unknown)
    Temporary link created. Inspect results for discarded items; order need not match input.

## Response 200 fields (application/json):

  - `uniqueId` (string)
    SignLink operation ID, not the EviSign ID.

  - `url` (string)
    Sensitive opaque signing URL. Use exactly as returned; its host follows the configured brand.

  - `expiresAt` (string)
    UTC expiration, one hour after creation.

  - `results` (array)

  - `results.evidenceId` (string)
    Requested EviSign identifier.

  - `results.discarded` (boolean)

  - `results.discardReason` (string)
    Reason for exclusion; null for accepted items.

  - `results.lookupKey` (string)
    Client lookup key.

  - `results.state` (string)
    Enum: "Draft", "Submitted", "Processed", "Sent", "Closed", "Forwarded", "Received"

  - `results.outcome` (string)
    Enum: "None", "Signed", "Rejected", "Failed", "Expired", "Cancelled"

  - `results.creationDate` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.lastStateChangeDate` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.submittedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.processedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.sentOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.closedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.signedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.rejectedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.failedOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.expiredOn` (string)
    EviSign timestamp; unavailable metadata on discarded items must not be interpreted.

  - `results.timeToLive` (integer)
    Lifetime in minutes from submittedOn; ignore default values for discarded items.

## Response 400:

  - `400` (unknown)
    Invalid parameters, incompatible multiple-item settings or unsupported Lite Flow configuration.

## Response 400 fields (application/json):

  - `responseStatus` (object)

  - `responseStatus.errorCode` (string)
    Diagnostic text: may be an exception name or a localized status description. Branch on HTTP status, not this value.

  - `responseStatus.message` (string)

  - `responseStatus.stackTrace` (string)

  - `responseStatus.errors` (array)

  - `responseStatus.errors.errorCode` (string)

  - `responseStatus.errors.fieldName` (string)

  - `responseStatus.errors.message` (string)

  - `responseStatus.errors.stackTrace` (string)

  - `responseStatus.errorId` (string)

  - `responseStatus.statusCode` (integer)

## Response 400 headers (application/json):

  - `X-Evi-Error-Id` (string)
    Error correlation ID; also returned in responseStatus.errorId.

## Response 401:

  - `401` (unknown)
    Authentication missing or invalid. Empty response body.

## Response 409:

  - `409` (unknown)
    All items discarded or discarded count exceeds DiscardedThreshold.

## Response 409 fields (application/json):

  - `responseStatus` (object)

  - `responseStatus.errorCode` (string)
    Diagnostic text: may be an exception name or a localized status description. Branch on HTTP status, not this value.

  - `responseStatus.message` (string)

  - `responseStatus.stackTrace` (string)

  - `responseStatus.errors` (array)

  - `responseStatus.errors.errorCode` (string)

  - `responseStatus.errors.fieldName` (string)

  - `responseStatus.errors.message` (string)

  - `responseStatus.errors.stackTrace` (string)

  - `responseStatus.errorId` (string)

  - `responseStatus.statusCode` (integer)

## Response 409 headers (application/json):

  - `X-Evi-Error-Id` (string)
    Error correlation ID; also returned in responseStatus.errorId.

## Response 500:

  - `500` (unknown)
    Unexpected error, or API/EviSign service not enabled.

## Response 500 fields (application/json):

  - `responseStatus` (object)

  - `responseStatus.errorCode` (string)
    Diagnostic text: may be an exception name or a localized status description. Branch on HTTP status, not this value.

  - `responseStatus.message` (string)

  - `responseStatus.stackTrace` (string)

  - `responseStatus.errors` (array)

  - `responseStatus.errors.errorCode` (string)

  - `responseStatus.errors.fieldName` (string)

  - `responseStatus.errors.message` (string)

  - `responseStatus.errors.stackTrace` (string)

  - `responseStatus.errorId` (string)

  - `responseStatus.statusCode` (integer)

## Response 500 headers (application/json):

  - `X-Evi-Error-Id` (string)
    Error correlation ID; also returned in responseStatus.errorId.

