EnrollDaemon

nokku.v1.DaemonService

POST

https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon

header Parameters

Connect-Protocol-Versionnumberrequired

Example 1

Connect-Timeout-Ms?number

Example 0

Authorization

BearerAuth (bearer)
PASETO token authentication. Include the token in the Authorization header: `Authorization: Bearer <token>`
CookieAuth (apiKey in cookie)
Cookie-based authentication (recommended for web applications). The session cookie is automatically sent by browsers after login.

Request Body

required

application/json

object

token?

string

caId?

string

authMethod?

string

authPubkey?

string

Responses

200

Success

application/json

object

id?

string

workspaceId?

string

targetId?

string

status?

string

Enum:"DAEMON_STATUS_UNSPECIFIED""DAEMON_STATUS_PENDING""DAEMON_STATUS_ACCEPTED""DAEMON_STATUS_REJECTED"

config?

object

recordSessions?

boolean

default

Error

application/json

object

Error type returned by Connect: https://connectrpc.com/docs/go/errors/#http-representation

code?

string

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

Enum:"canceled""unknown""invalid_argument""deadline_exceeded""not_found""already_exists""permission_denied""resource_exhausted""failed_precondition""aborted""out_of_range""unimplemented""internal""unavailable""data_loss""unauthenticated"

message?

string

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?

array<object>

A list of messages that carry the error details. There is no limit on the number of messages.

object

Contains an arbitrary serialized message along with a @type that describes the type of the serialized message, with an additional debug field for ConnectRPC error details.

type?

string

A URL that acts as a globally unique identifier for the type of the serialized message. For example: `type.googleapis.com/google.rpc.ErrorInfo`. This is used to determine the schema of the data in the `value` field and is the discriminator for the `debug` field.

value?

string <binary>

The Protobuf message, serialized as bytes and base64-encoded. The specific message type is identified by the `type` field.

debug?

one of 1

Deserialized error detail payload. The 'type' field indicates the schema. This field is for easier debugging and should not be relied upon for application logic.

One of

Option 1?

object

Detailed error information.

Code Samples

curl -X POST 'https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon' \
  -H "Authorization: Bearer <token>" \
  -H 'Content-Type: application/json' \
  -d '{
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}'

const response = await fetch('https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon', {
  method: 'POST',
  headers: {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
},
  body: JSON.stringify({
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}),
});

const data = await response.json();
console.log(data);

import requests

url = 'https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon'
headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
}
payload = {
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

package main

import (
  "bytes"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body := bytes.NewBuffer([]byte(`{
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}`))
  req, err := http.NewRequest("POST", "https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon", body)
  if err != nil { panic(err) }
  req.Header.Set("Authorization", "Bearer <token>")
  req.Header.Set("Content-Type", "application/json")

  res, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer res.Body.Close()

  payload, err := io.ReadAll(res.Body)
  if err != nil { panic(err) }
  fmt.Println(string(payload))
}

using System.Net.Http;
using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon");
request.Headers.Add("Authorization", "Bearer <token>");
request.Content = new StringContent(
    """"{
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}"""",
    System.Text.Encoding.UTF8,
    "application/json"
);

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
  public static void main(String[] args) throws Exception {
    HttpClient client = HttpClient.newHttpClient();
    HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://app.nokku.sh/nokku.v1.DaemonService/EnrollDaemon"))
      .header("Authorization", "Bearer <token>")
      .header("Content-Type", "application/json")
      .method("POST", HttpRequest.BodyPublishers.ofString("""{
  "token": "string",
  "caId": "string",
  "authMethod": "string",
  "authPubkey": "string"
}"""))
      .build();

    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  }
}

EnrollDaemon

header Parameters

Authorization

Request Body

Responses

Code Samples

Example Responses