Skip to main content
POST
/
v1
/
api
/
auth
/
sessions
Create an API auth session
curl --request POST \
  --url https://public.api.paragraph.com/api/v1/api/auth/sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "deviceName": "<string>",
  "callbackUrl": "<string>"
}
'
{
  "sessionId": "<string>",
  "verificationUrl": "<string>",
  "expiresAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://paragraph.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json

Body

​
deviceName
string

Name of the device requesting access (e.g. user@MacBook-Pro.local)

Maximum string length: 100
​
callbackUrl
string<uri>

HTTPS callback URL to redirect the user to after approving the session

Maximum string length: 2048

Response

Session created successfully

​
sessionId
string
required

Unique session identifier

​
verificationUrl
string
required

URL to open in the browser to approve the session

​
expiresAt
string
required

ISO 8601 timestamp when the session expires