> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getruba.com/llms.txt
> Use this file to discover all available pages before exploring further.
# End Seat
> ### Intent
Removes the seat.
### When to call it
Call this only after your application has identified the seat that should be removed.
### Access boundary
Authorize the request with a token that carries `customer_portal:write`.
### Successful result
A successful request returns `200`. The response schema below defines the body your integration receives.
export const RubaSocials = () => {
if (typeof document === "undefined") {
return null;
}
const inject = () => {
const footer = document.getElementById("footer");
if (!footer || document.getElementById("ruba-socials")) {
return false;
}
const isDark = document.querySelector("html.dark") || document.querySelector('html[class*="dark"]');
const lineColor = isDark ? "#383838" : "#e8e8ed";
const iconColor = isDark ? "#8e8e93" : "#86868b";
const markColor = isDark ? "#ffffff" : "#08080c";
const hoverColor = "#0071e3";
const div = document.createElement("div");
div.id = "ruba-socials";
div.style.cssText = `display:flex;align-items:center;gap:20px;padding-top:20px;margin-top:20px;border-top:1px solid ${lineColor};width:100%`;
const logo = `Ruba`;
const spacer = ``;
const ig = ``;
const li = ``;
const x = ``;
const github = ``;
div.innerHTML = logo + spacer + ig + li + x + github;
footer.appendChild(div);
return true;
};
if (!document.documentElement.dataset.rubaSocialsObserver) {
document.documentElement.dataset.rubaSocialsObserver = "true";
const observer = new MutationObserver(() => {
if (!document.getElementById("ruba-socials")) {
inject();
}
});
observer.observe(document.body, {
childList: true,
subtree: true
});
}
setTimeout(() => {
if (!inject()) {
const interval = setInterval(() => {
if (inject()) {
clearInterval(interval);
}
}, 500);
setTimeout(() => clearInterval(interval), 10000);
}
}, 300);
return null;
};
## OpenAPI
````yaml delete /v1/customer-portal/seats/{seat_id}
openapi: 3.1.0
info:
title: Ruba API
summary: Ruba HTTP and Webhooks API
description: '**Details:** Read the docs at https://docs.getruba.com/api-reference.'
version: 2026-04
servers:
- url: https://api.getruba.com
description: '**Details:** Production environment.'
x-speakeasy-server-id: production
- url: https://sandbox-api.getruba.com
description: '**Details:** Sandbox environment.'
x-speakeasy-server-id: sandbox
security: []
tags:
- name: public
description: >-
**Details:** Endpoints shown and documented in the Ruba API documentation
and available in our SDKs.
- name: private
description: >-
**Details:** Endpoints that should appear in the schema only in
development to generate our internal JS SDK.
paths:
/v1/customer-portal/seats/{seat_id}:
delete:
tags:
- customer_portal
- seats
- public
summary: End Seat
description: >-
### Intent
Removes the seat.
### When to call it
Call this only after your application has identified the seat that
should be removed.
### Access boundary
Authorize the request with a token that carries `customer_portal:write`.
### Successful result
A successful request returns `200`. The response schema below defines
the body your integration receives.
operationId: customer_portal:seats:revoke_seat
parameters:
- name: seat_id
in: path
required: true
schema:
type: string
format: uuid4
title: Seat Id
responses:
'200':
description: Request completed successfully
content:
application/json:
schema:
$ref: '#/components/schemas/CustomerSeat'
'401':
description: Requires authentication
'403':
description: '**Response:** Not permitted or seat-based pricing not enabled.'
'404':
description: '**Response:** Seat could not be found.'
'422':
description: Request validation failed
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- customer_session:
- customer_portal:write
- member_session:
- customer_portal:write
components:
schemas:
CustomerSeat:
properties:
created_at:
type: string
format: date-time
title: Created At
description: The time Ruba created this record.
modified_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Modified At
description: The time this record last changed.
id:
type: string
format: uuid
title: Id
description: '**Id:** Seat ID.'
subscription_id:
anyOf:
- type: string
format: uuid
- type: 'null'
title: Subscription Id
description: '**Subscription Id:** Subscription ID (for recurring seats).'
order_id:
anyOf:
- type: string
format: uuid
- type: 'null'
title: Order Id
description: '**Order Id:** Order ID (for one-time purchase seats).'
status:
$ref: '#/components/schemas/SeatStatus'
description: '**Status:** Status of the seat.'
customer_id:
anyOf:
- type: string
format: uuid
- type: 'null'
title: Customer Id
description: >-
**Customer Id:** Customer ID. When member_model_enabled is true,
this is the billing customer (purchaser). When false, this is the
seat member customer.
member_id:
anyOf:
- type: string
format: uuid
- type: 'null'
title: Member Id
description: '**Member Id:** Member ID of the seat occupant.'
member:
anyOf:
- $ref: '#/components/schemas/Member'
- type: 'null'
description: '**Member:** Member associated with this seat.'
email:
anyOf:
- type: string
- type: 'null'
title: Email
description: >-
**Email:** Email of the seat member (set when member_model_enabled
is true).
customer_email:
anyOf:
- type: string
- type: 'null'
title: Customer Email
description: '**Customer Email:** Assigned customer email.'
invitation_token_expires_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Invitation Token Expires At
description: '**Invitation Token Expires At:** When the invitation token expires.'
claimed_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Claimed At
description: '**Claimed At:** When the seat was claimed.'
revoked_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Revoked At
description: '**Revoked At:** When the seat was revoked.'
seat_metadata:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Seat Metadata
description: '**Seat Metadata:** Additional metadata for the seat.'
type: object
required:
- created_at
- modified_at
- id
- status
title: CustomerSeat
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
SeatStatus:
type: string
enum:
- pending
- claimed
- revoked
title: SeatStatus
Member:
properties:
id:
type: string
format: uuid4
title: Id
description: Unique identifier for the member.
created_at:
type: string
format: date-time
title: Created At
description: The time Ruba created this record.
modified_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Modified At
description: The time this record last changed.
customer_id:
type: string
format: uuid4
title: Customer Id
description: Unique identifier for the customer this member belongs to.
email:
type: string
title: Email
description: '**Email:** Email address of the member.'
examples:
- member@example.com
name:
anyOf:
- type: string
- type: 'null'
title: Name
description: Name assigned to the member.
examples:
- Jane Doe
external_id:
anyOf:
- type: string
- type: 'null'
title: External Id
description: >-
Identifier of the member in your system. This must be unique within
the customer..
examples:
- usr_1337
role:
$ref: '#/components/schemas/MemberRole'
description: '**Role:** Role of the member within the customer.'
examples:
- owner
type: object
required:
- id
- created_at
- modified_at
- customer_id
- email
- name
- external_id
- role
title: Member
description: Object representing member of a customer.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
MemberRole:
type: string
enum:
- owner
- billing_manager
- member
title: MemberRole
securitySchemes:
customer_session:
type: http
description: >-
**Authentication:** Customer session tokens authenticate buyers within
your organization. Generate one through the [customer session
operation](/api-reference/customer-portal/sessions/create).
scheme: bearer
member_session:
type: http
description: >-
**Authentication:** Member session tokens authenticate team members
within a customer account. Generate one through the [member session
operation](/api-reference/member-portal/sessions/create).
scheme: bearer
````