Skip to main content
POST
/
handshake
Handshake
curl --request POST \
  --url https://api.example.com/handshake \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "target_did": "<string>"
}
'
{
  "session_token": "<string>",
  "expires_at": "<string>"
}
Use this endpoint to authenticate and establish a session with a target node.

Headers

x-api-key
string
required
Registry-issued API key (sk-aris-...).

Body

target_did
string
required
DID of the worker node you want to target.

Success response

session_token
string
Signed short-lived token used in subsequent generation requests.
expires_at
string
Expiration timestamp in ISO-8601 format.

Error responses

StatusMeaning
401Invalid API key.
402Insufficient account balance.
404Target node not found.
503Registry temporarily unavailable.
Last modified on February 21, 2026