peers

Get Or Create Peer

Changed on

Get a Peer by ID or create a new Peer with the given ID.

If peer_id is provided as a query parameter, it uses that (must match JWT workspace_id). Otherwise, it uses the peer_id from the JWT.

post/v3/workspaces/{workspace_id}/peers

Request

  • Base URL
    https://api.honcho.dev
  • Auth
    HTTP bearer

Path parameters

workspace_idstring required

Request body

idstring required
metadataobject nullable
configurationobject nullable

Response

Successful Response

idstring required
uidstring required

Immutable identifier Honcho assigns to this peer. id is the name the client chose; uid is generated by the server.

workspace_idstring required
created_atstring date-time required
metadataobject
configurationobject

Changes