Skip to content
Dashboard
Theme
Theme

Unlink a Passport from one of your organizations

DELETE /v1/passport/links/{link}: Unlink a Passport from one of your organizations.

View Markdown

DELETE /v1/passport/links/{link}

The vendor side of OhAuthCat Passport: ends a live link between a Passport and one of your organizations at once, revoking all of its sharing grants (domain_proof, guidance, read), so it can no longer lend domain proof, read setup status or start a rotation. The holder sees the unlink in their Passport activity. Answers the ended link (status: unlinked); another environment’s link or an already ended one answers resource_not_found.

Scope
organizations:write
Auth
Secret key (sk_…)
Since
1.1
  • link string Required

    The Passport link ID (pptl_...).

    max length 64

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

Errors share one shape; see the error code catalogue.

curl -X DELETE \
"https://api.ohauthcat.com/v1/passport/links/example_link" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"object": "passport_link",
"id": "01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"organization_id": "org_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
"status": "linked",
"linked_at": "2026-01-15T09:30:00Z",
"unlinked_at": "2026-01-15T09:30:00Z",
"grants": {
"domain_proof": true,
"guidance": true,
"read": true
}
}