Skip to main content
DELETE
/
v1
/
customer-seats
/
{seat_id}
Python (SDK)
from polar_sdk import Polar


with Polar(
    access_token="<YOUR_BEARER_TOKEN_HERE>",
) as polar:

    res = polar.customer_seats.revoke_seat(seat_id="<id>")

    # Handle response
    print(res)
{
  "created_at": "2023-11-07T05:31:56Z",
  "modified_at": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "customer_email": "<string>",
  "invitation_token_expires_at": "2023-11-07T05:31:56Z",
  "claimed_at": "2023-11-07T05:31:56Z",
  "revoked_at": "2023-11-07T05:31:56Z",
  "seat_metadata": {}
}

Authorizations

​
Authorization
string
header
required

You can generate an Organization Access Token from your organization's settings.

Path Parameters

​
seat_id
string
required

Response

Successful Response

​
created_at
string<date-time>
required

Creation timestamp of the object.

​
modified_at
string<date-time> | null
required

Last modification timestamp of the object.

​
id
string<uuid>
required

The seat ID

​
status
enum<string>
required

Status of the seat

Available options:
pending,
claimed,
revoked
​
subscription_id
string<uuid> | null

The subscription ID (for recurring seats)

​
order_id
string<uuid> | null

The order ID (for one-time purchase seats)

​
customer_id
string<uuid> | null

The assigned customer ID

​
customer_email
string | null

The assigned customer email

​
invitation_token_expires_at
string<date-time> | null

When the invitation token expires

​
claimed_at
string<date-time> | null

When the seat was claimed

​
revoked_at
string<date-time> | null

When the seat was revoked

​
seat_metadata
object | null

Additional metadata for the seat