Skip to content
Qualia Docs

Episodes_TakeOverEpisodeLease

POST
/v1/accounts/{account}/datasets/{dataset}/episodes/{episode}:takeOverEpisodeLease
 
curl --request POST \
  --url https://junction-api.qualiastudios.dev/v1/accounts/example/datasets/example/episodes/example:takeOverEpisodeLease \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "episode": "example", "tab": "example" }'

Replaces another person’s live lease with the caller’s, for this tab, and records EPISODE_LEASE_TAKEN (not undoable). Admins and owners only. With no live lease of another person it acquires, and records nothing.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
account
required
string

The account id.

dataset
required
string

The dataset id.

episode
required
string

The episode id.

Request Body required

Section titled “Request Body required ”
Media type application/json

Request for Episodes.TakeOverEpisodeLease.

object
episode
required

Accounts/{account}/datasets/{dataset}/episodes/{episode}

string
tab
required

The caller’s tab.

string
Example generated
{
  "episode": "example",
  "tab": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

OK

Media type application/json

Response for Episodes.TakeOverEpisodeLease.

object
lease

The caller’s lease.

object
holder

The holder’s user id (as Actor.user).

string
holderName

The holder’s display name at the time they took it; empty when they have none.

string
expireTime

When it lapses unless renewed.

string format: date-time
Example generated
{
  "lease": {}
}

default

Section titled “default ”

Default error response

Media type application/json
One of:
API error

A refusal from the API itself.

object
code
required

The gRPC code name in upper case, e.g. NOT_FOUND.

string
message
required
string
retryable
required

Whether the same call may succeed if retried.

boolean
details
required

Empty, except when a dataset copy or move is refused: then one google.rpc.ErrorInfo with the refusal’s reason code, its domain and, in metadata, the datasets it names.

Array<object>
object
Example generated
{
  "code": "example",
  "message": "example",
  "retryable": true,
  "details": [
    {}
  ]
}