Re-authenticate existing sender UI

Request

Create a new one-time authentication URL for an existing Sender UI. Use this when the previous URL has expired or has already been used.

See details about URL behavior in create sender UI.

Security

APIKey

Path

session_idstring, (uuid)required

The UUID of the signing session.

Example:0196ae5b-2e9d-729f-aba5-fa4db6f881fd

sender_ui_idstring, (uuid)required

The UUID of the sender UI to authenticate.

Example:0196ae5b-2e9d-729f-aba5-fa4db6f88401

Acceptstringrequired

Specify the response format.

Value:"application/json"

Bodyapplication/json

ui_languagestring(App.Enums.UiLanguage)

Enum:"en-GB""fi""de""pl""sv"

curl -i -X POST \
  https://api.embed.docue.com/sign/sessions/0196ae5b-2e9d-729f-aba5-fa4db6f881fd/sender-uis/0196ae5b-2e9d-729f-aba5-fa4db6f88401/authenticate \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <YOUR_API Key_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "ui_language": "en-GB"
  }'

Responses

Successfully authenticated sender UI.

Bodyapplication/json

dataobject(SigningSessionSenderUiAuthenticatedData)required

Response body. Null when there is nothing to return.

metaobjectrequired

Response

{
  "data": {
    "id": "0196ae5b-2e9d-729f-aba5-fa4db6f88401",
    "url": "https://sign.docue.com/sender-session/0196ae5b-2e9d-729f-aba5-fa4db6f88401#access-code",
    "handlers": { … },
    "configuration": { … },
    "created_at": "2026-02-12T10:30:00Z",
    "updated_at": "2026-02-12T10:35:00Z",
    "last_authenticated_at": "2026-02-12T10:35:00Z"
  },
  "meta": {
    "status": { … }
  }
}