Skip to main content
GET
/
api
/
detection
/
sessions
/
{session_id}
Get Detection Session
curl --request GET \
  --url https://api.kynasmith.dev/api/detection/sessions/{session_id} \
  --header 'Authorization: Bearer <token>'
{
  "accepted_frames_total": 123,
  "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "project_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resolved_movespec_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ended_at": "2023-11-07T05:31:56Z",
  "error_code": "<string>",
  "error_message": "<string>",
  "started_at": "2023-11-07T05:31:56Z",
  "terminal_outcome": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.kynasmith.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Backend-issued machine access token for project-scoped API access.

Path Parameters

​
session_id
string<uuid>
required

Response

Successful Response

Persisted customer detection-session resource.

​
accepted_frames_total
integer
required

Total number of accepted frames for the session.

​
mode
enum<string>
required

Runtime mode for the session.

Available options:
live,
replay
​
organization_id
string<uuid>
required

Owning organization identifier.

​
project_id
string<uuid>
required

Owning project identifier.

​
resolved_movespec_version_id
string<uuid>
required

Resolved immutable MoveSpec version for customer runtime.

​
session_id
string<uuid>
required

Detection session identifier.

​
status
enum<string>
required

Current session lifecycle state.

Available options:
created,
streaming,
finalizing,
completed,
failed,
cancelled
​
ended_at
string<date-time> | null

Timestamp when the session became terminal.

​
error_code
string | null

Top-level terminal error code when present.

​
error_message
string | null

Top-level terminal error message when present.

​
started_at
string<date-time> | null

Timestamp when streaming began.

​
terminal_outcome
string | null

Terminal outcome summary when the session ends.