Skip to content
HalvorAI mark HalvorAI mark HalvorAI

Register a source

POST
/v1/sources

Registers an SDK installation and its Ed25519 public key.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
name
required
string
>= 1 characters <= 100 characters
adapter
required
string
Allowed values: stripe stripe-issuing x402-client x402-server mpp-server mcp manual custom
public_jwk
required
object
kty
required
string
Allowed values: OKP
crv
required
string
Allowed values: Ed25519
x
required
string
/^[A-Za-z0-9_-]{43}$/
kid
string
<= 128 characters
alg
string
Allowed values: EdDSA
use
string
Allowed values: sig

Responses

Section titled “ Responses ”

201

Section titled “201 ”

The source id

object
id
required
string

400

Section titled “400 ”

The request is not valid

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W

401

Section titled “401 ”

Not signed in, or the API key is not valid

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W

403

Section titled “403 ”

Not allowed for this role or key

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W