> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bidsmith.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Handshake

> Create a session token for a target node before generation.

Use this endpoint to authenticate and establish a session with a target node.

## Headers

<ParamField name="x-api-key" header="x-api-key" type="string" required>
  Registry-issued API key (`sk-aris-...`).
</ParamField>

## Body

<ParamField name="target_did" body="target_did" type="string" required>
  DID of the worker node you want to target.
</ParamField>

## Success response

<ResponseField name="session_token" type="string">
  Signed short-lived token used in subsequent generation requests.
</ResponseField>

<ResponseField name="expires_at" type="string">
  Expiration timestamp in ISO-8601 format.
</ResponseField>

## Error responses

| Status | Meaning                           |
| ------ | --------------------------------- |
| `401`  | Invalid API key.                  |
| `402`  | Insufficient account balance.     |
| `404`  | Target node not found.            |
| `503`  | Registry temporarily unavailable. |