Retrieve a Forward session by ID.
GET /api/v1/forward/sessions/{session_id}
Returns stable Forward session fields. Runtime-private fields are not exposed by default.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT or SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | Session ID. |
Example request
Example response
HTTP 200 OK
Response fields
Returns the Session object.
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 401 | authentication_error | authentication_required | PAT or SAT invalid or expired. |
| 404 | not_found_error | session_not_found | Session does not exist or is not visible to the caller. |
Notes
- Forward validates account and Template ownership before reading runtime facts.
- If the underlying runtime session is missing, Forward returns
404 session_not_found.