UploadRecording
UploadRecording
https://app.nokku.sh/nokku.v1.DaemonControlService/UploadRecordingTry it
Header Parameters
Define the version of the Connect protocol
Define the timeout, in ms
Authorization
BearerAuth (bearer)
A service account token. Include it in the Authorization header: `Authorization: Bearer <token>`
CookieAuth (cookie: __Host-nokku_session)
The session cookie the web app uses. Browsers send it after sign-in. Only on `localhost` it is named `nokku_session`.
Request Body
RequiredAt most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
At most one of `meta`, `chunk`, `final` may be set.
meta?recordingId?username?principal?startedAt?A point in time in RFC 3339 format, with up to nanosecond precision. Output uses UTC (`Z`); input may use an offset from UTC.
chunk?final?sizeBytes?int64.gte = 0
cutReason?endedAt?ended_at is when the session ended, which a late upload can be long after.
Responses
200Success
200Success
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
recordingId?sizeBytes?size_bytes is what the core holds of the recording.
complete?complete says the core takes no more of this recording. Only this answer lets a daemon delete its file, an error never does.
defaultError
defaultError
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation
code?The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
message?A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
details?A list of messages that carry the error details. There is no limit on the number of messages.
Code Samples
curl -X POST 'https://app.nokku.sh/nokku.v1.DaemonControlService/UploadRecording' \
-H 'Authorization: Bearer <token>' \
-H 'Content-Type: application/connect+json' \
-d '{
"meta": {
"recordingId": "bbd0b35c-32e1-4c5f-b1be-7f8fdbe015f2",
"username": "string",
"principal": "string",
"startedAt": "2023-01-15T01:30:15.01Z"
},
"chunk": "string",
"final": {
"sizeBytes": "string",
"cutReason": "string",
"endedAt": "2023-01-15T01:30:15.01Z"
}
}'const response = await fetch("https://app.nokku.sh/nokku.v1.DaemonControlService/UploadRecording", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/connect+json"
},
body: JSON.stringify({
"meta": {
"recordingId": "bbd0b35c-32e1-4c5f-b1be-7f8fdbe015f2",
"username": "string",
"principal": "string",
"startedAt": "2023-01-15T01:30:15.01Z"
},
"chunk": "string",
"final": {
"sizeBytes": "string",
"cutReason": "string",
"endedAt": "2023-01-15T01:30:15.01Z"
}
}),
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"POST",
"https://app.nokku.sh/nokku.v1.DaemonControlService/UploadRecording",
headers={
"Authorization": "Bearer <token>"
},
json={
"meta": {
"recordingId": "bbd0b35c-32e1-4c5f-b1be-7f8fdbe015f2",
"username": "string",
"principal": "string",
"startedAt": "2023-01-15T01:30:15.01Z"
},
"chunk": "string",
"final": {
"sizeBytes": "string",
"cutReason": "string",
"endedAt": "2023-01-15T01:30:15.01Z"
}
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"meta": {
"recordingId": "bbd0b35c-32e1-4c5f-b1be-7f8fdbe015f2",
"username": "string",
"principal": "string",
"startedAt": "2023-01-15T01:30:15.01Z"
},
"chunk": "string",
"final": {
"sizeBytes": "string",
"cutReason": "string",
"endedAt": "2023-01-15T01:30:15.01Z"
}
}`)
req, err := http.NewRequest("POST", "https://app.nokku.sh/nokku.v1.DaemonControlService/UploadRecording", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer <token>")
req.Header.Set("Content-Type", "application/connect+json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(string(data))
}Example Responses
{
"recordingId": "string",
"sizeBytes": "string",
"complete": true
}{
"code": "not_found",
"message": "string",
"details": [
{
"type": "string",
"value": "string",
"debug": {}
}
]
}