Skip to main content
POST
/
v1
/
mobile-handoff
/
session
Create Mobile Handoff Session
curl --request POST \
  --url https://api.kiriku.app/v1/mobile-handoff/session
{
  "sessionId": "<string>",
  "status": "pending",
  "file": {
    "originalName": "<string>",
    "mimeType": "<string>",
    "size": 123
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "uploadUrl": "<string>",
  "consumeUrl": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.kiriku.app/llms.txt

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

Create a new mobile handoff session.

​
Response

{
  "sessionId": "abc123def456",
  "uploadUrl": "https://api.kiriku.app/v1/mobile-handoff/upload/abc123def456",
  "consumeUrl": "https://api.kiriku.app/v1/mobile-handoff/consume/abc123def456",
  "status": "created",
  "expiresAt": "2024-03-13T12:00:00Z"
}

​
Notes

  • Le sessionId est valide pendant 30 minutes
  • Vous pouvez partager l’uploadUrl avec votre application mobile

​
Example

curl -X POST https://api.kiriku.app/v1/mobile-handoff/session

Response

200 - application/json

Session created successfully

​
sessionId
string

Unique session identifier

​
status
enum<string>

Session status

Available options:
pending,
uploaded,
consumed
​
file
object

File metadata (only present when uploaded)

​
createdAt
string<date-time>
​
uploadUrl
string

URL to upload file to this session

​
consumeUrl
string

URL to consume the uploaded file

​
expiresAt
string<date-time>

Session expiration time (15 minutes after creation)