Skip to main content
Opik Documentation

Search documentation

Type to search this documentation.

Create a pairing session

POST/v1/private/pairing/sessionsCreate a pairing session

Register a short-lived pairing session that a local daemon will later activate via HMAC

Request body

application/json
objectCreateSessionRequest
activation_keystringrequired

maxLength 44 · minLength 43

project_idstring · uuidrequired
ttl_secondsinteger · int32

maximum 600 · minimum 60

typestringrequired

one of "connect", "endpoint"

Example request
{
  "activation_key": "string",
  "project_id": "00000000-0000-0000-0000-000000000000",
  "ttl_seconds": 0,
  "type": "connect"
}

Responses

201Session createdapplication/json
objectCreateSessionResponse
runner_idstring · uuid
session_idstring · uuid
Example response
{
  "runner_id": "00000000-0000-0000-0000-000000000000",
  "session_id": "00000000-0000-0000-0000-000000000000"
}
400Bad requestapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
404Project not foundapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
422Unprocessable entityapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
429Too many requestsapplication/json
objectErrorMessage
codeinteger · int32
detailsstring
messagestring
Example response
{
  "code": 0,
  "details": "string",
  "message": "string"
}
Documentation menu