Morpheus API Gateway LogoMorpheus API Gateway
Session

Create Bid Session

Create a session with a provider using a bid ID and associate it with the API key. This endpoint creates a session and automatically associates it with the API key used for authentication. Each API key can have at most one active session at a time.

POST
/api/v1/session/bidsession

Authorization

Authorization<token>

Provide the API key in either format: 'Bearer sk-xxxxxx.yyyyyyy' or just 'sk-xxxxxx.yyyyyyy'. The prefix is 9 characters long including 'sk-'.

In: header

Request Body

application/jsonRequired
sessionDurationSessionduration
Default: 3600
directPaymentDirectpayment
Default: false
failoverFailover
Default: false

Query Parameters

bid_idRequiredBid Id

The blockchain ID (hex) of the bid to create a session for

Response Body

Successful Response

TypeScript Definitions

Use the response body type in TypeScript.

responseRequiredunknown
curl -X POST "http://api.mor.org/api/v1/session/bidsession?bid_id=string" \
  -H "Authorization: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionDuration": 3600,
    "directPayment": false,
    "failover": false
  }'
null

How is this guide?