Pin confirmation
Get Customer Pin Status
Check if a customer has a PIN set. Admin-only.
"Is it safe?" — Szell, Marathon Man (about PIN status)
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X GET "https://loading/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/pin" \ -H "X-Api-Key: string"{
"created_at": "2019-08-24T14:15:22Z",
"has_pin": true,
"is_active": false,
"is_locked": false,
"locked_until": "2019-08-24T14:15:22Z"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Set Customer Pin
Set a PIN for a customer. Admin-only.
If a PIN already exists, this replaces it (like a reset). The customer will need to enter this PIN when executing skills that have PIN confirmation enabled.
"I'll make him a PIN he can't refuse." — Don Corleone, The Godfather
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X POST "https://loading/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/pin" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{ "pin": "string" }'{
"created_at": "2019-08-24T14:15:22Z",
"has_pin": true,
"is_active": false,
"is_locked": false,
"locked_until": "2019-08-24T14:15:22Z"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Remove Customer Pin
Remove a customer's PIN. Admin-only.
"Forget about it, Jake. It's Chinatown." — Chinatown (about removing PINs)
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X DELETE "https://loading/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08/pin" \ -H "X-Api-Key: string"{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Pin Policy
Get the PIN policy for an instance.
"What's the frequency, Kenneth?" — R.E.M. (about checking PIN policy)
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X GET "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/pin-policy" \ -H "X-Api-Key: string"{
"instance_id": "string",
"pin_applies_to": "all",
"pin_required_skills": [],
"pin_session_ttl_minutes": 30
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Update Pin Policy
Update the PIN policy for an instance. Admin-only.
Configure which skills require PIN confirmation, the session TTL, and whether it applies to owner, customer, or all roles.
"I am altering the deal. Pray I don't alter it any further." — Darth Vader, The Empire Strikes Back (about updating PIN policies)
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X PATCH "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/pin-policy" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{}'{
"instance_id": "string",
"pin_applies_to": "all",
"pin_required_skills": [],
"pin_session_ttl_minutes": 30
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get My Pin Status
Check if the current authenticated user has a PIN set.
Used by the frontend Security section — no customer_id needed, just uses the JWT context. "Who am I? I'm the guy with the PIN." — Frank Castle, if he used fintech apps
In: header
Header Parameters
Response Body
curl -X GET "https://loading/v1/me/pin" \ -H "X-Api-Key: string"{
"created_at": "2019-08-24T14:15:22Z",
"has_pin": true,
"is_active": false,
"is_locked": false,
"locked_until": "2019-08-24T14:15:22Z"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}