Get an episode

Request

Get an episode by its ID. Omit version to return its latest version.

Security

ApiKey(Required scopes: episodes.list)

Path

idstringrequired

Episode ID

Query

versioninteger, [ 1 .. 2147483647 ]

Episode version to read. Defaults to the latest version.

includeArray of strings

Comma-separated list of optional related data to include on the episode.

Items Enum:"recordings""properties"

Payload

// No request payload

Responses

The episode

Bodyapplication/json

versioninteger, >= 1required

The episode version represented by this response.

latestVersioninteger, >= 1required

The episode's latest version at the time of this read.

propertiesobject(EpisodeProperties)

Custom properties at the selected version. Returned only with include=properties.

creationContextobject or null(EpisodeCreationContext)

Original creation context. Always present when fetching an episode by ID; present on list responses only with ?include=creationContext.

idstringrequired

ID of the episode.

projectIdstringrequired

ID of the project the episode belongs to.

startTimestring, (date-time)required

Inclusive start of the episode window, with up to nanosecond precision.

endTimestring, (date-time)required

Inclusive end of the episode window, with up to nanosecond precision. Equal to startTime for a single instant.

recordingsArray of objects

Member recordings. Present only when the request includes ?include=recordings.

hasMissingRecordingsboolean

Whether any member recording has no data at a Primary Site. Returned by episode endpoints only with include=recordings. Dataset endpoints report this on the containing dataset entry instead.

creatorOrgMemberIdstring or null

ID of the org member who created the episode. Null when the episode was created via API-key auth (in which case creatorApiKeyId is set).

creatorApiKeyIdstring or null

ID of the API key that created the episode. Null when the episode was created via session auth (in which case creatorOrgMemberId is set).

createdAtstring, (date-time)required

Timestamp when the episode was created.

Response

{
  "version": 1,
  "latestVersion": 1,
  "properties": {
    "property1": "string",
    "property2": "string"
  },
  "creationContext": {
    "version": 1,
    "basis": { … },
    "derivedFromEpisodeId": "string",
    "search": { … }
  },
  "id": "string",
  "projectId": "string",
  "startTime": "2019-08-24T14:15:22Z",
  "endTime": "2019-08-24T14:15:22Z",
  "recordings": [
    { … }
  ],
  "hasMissingRecordings": true,
  "creatorOrgMemberId": "string",
  "creatorApiKeyId": "string",
  "createdAt": "2019-08-24T14:15:22Z"
}