Skip to content
Kesita Kesita Kesita docs

Read immutable source metadata

GET
/v1/legal/sources/{versionId}

Returns metadata for a specific, immutable published source version.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
versionId
required
string format: uuid

Immutable source-version identifier.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Immutable source-version metadata

object
source_version_id
required
string format: uuid
title
required
string
>= 1 characters
provenance
required
object
canonical_url
required
string format: uri
content_sha256
required

Lowercase hexadecimal SHA-256 digest.

string
/^[a-f0-9]{64}$/

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.

401

Section titled “401 ”

Missing or invalid OAuth access token

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

403

Section titled “403 ”

The client is disabled or lacks the required scope

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

404

Section titled “404 ”

Source version or passage not found

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.

429

Section titled “429 ”

Request quota exceeded

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

Retry-After
integer
>= 1

Seconds before the client should retry.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.

503

Section titled “503 ”

Legal Core is temporarily unavailable

object
type
required
string format: uri
Example
https://kesita.ai/problems/bad-request
title
required
string
status
required
integer
detail
string
instance
string
request_id
string

Headers

Section titled “Headers ”
X-Request-ID
string format: uuid

Correlation identifier for support and tracing.

RateLimit-Limit
integer
>= 1

Maximum requests allowed in the current minute.

RateLimit-Remaining
integer

Requests remaining in the current minute.

RateLimit-Reset
integer

Seconds until the current minute window resets.