> ## 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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.