Seats Full

Triggered when all purchased seats in a workspace are utilized (no available seats remain).

WEBHOOK workspace:seats_full

Example Request Body

{
  "workspace_id": "my-workspace",
  "event_type": "workspace:seats_full",
  "partner_id": "partner_12345",
  "triggered_at": "2024-01-01T12:00:00.000Z",
  "seats_purchased": 10,
  "seats_available": 10
}

Headers

X-TL-Partner-Id · string · required

The unique identifier for the partner.

X-TL-Signature · string · required

A JSON Web Token (JWT) signed with your Partner Secret using the HS256 algorithm. Use this header to verify that the webhook was genuinely sent by TimelinesAI.

The JWT contains the following claims: | Claim | Description | |-------|-------------| | partner_id | Your partner identifier — must match the X-TL-Partner-Id header | | nbf | Not-before timestamp (Unix epoch) | | exp | Expiration timestamp (Unix epoch) |

Verification steps:

1. Extract the X-TL-Signature header value from the incoming request.
2. Decode and verify the JWT using your Partner Secret with the HS256 algorithm.
3. Confirm that the partner_id claim matches the X-TL-Partner-Id header.
4. Reject the request if verification fails (invalid signature, expired token, or mismatched partner ID).

JavaScript example:

const jwt = require(''jsonwebtoken'');
function verifyWebhook(req) {
  const signature = req.headers[''x-tl-signature''];
  const partnerId = req.headers[''x-tl-partner-id''];
  try {
    const decoded = jwt.verify(signature, PARTNER_SECRET);
    return decoded.partner_id === partnerId;
  } catch (err) {
    return false;
  }
}

Python example:

import jwt
def verify_webhook(headers):
    signature = headers.get(''X-TL-Signature'')
    partner_id = headers.get(''X-TL-Partner-Id'')
    try:
        decoded = jwt.decode(signature, PARTNER_SECRET, algorithms=[''HS256''])
        return decoded[''partner_id''] == partner_id
    except jwt.InvalidTokenError:
        return False

See the PartnerAPI Webhooks Overview for more details.

Body

application/json

Webhook payload sent when all purchased seats in a workspace are utilized (available seats reach zero). This event is emitted once per billing period when the condition seats_utilized >= seats_purchased becomes true.

workspace_id · string · required

Identifier of the workspace whose seat utilization reached the purchased limit.

Example:

"my-workspace"

event_type · enum<string> · required

Partner webhook event name.

Available options: workspace:seats_full

partner_id · string · required

Unique identifier of the partner that owns the workspace.

Example:

"partner_12345"

triggered_at · string<date-time> · required

Timestamp when the threshold condition was first met for the current billing period.

Example:

"2024-01-01T12:00:00.000Z"

seats_purchased · integer · required

Number of seats purchased for the workspace in the current billing period.

Example:

10

seats_available · integer · required

Number of seats still available for assignment in the workspace.

Example:

10

Response

200

Receiver accepted the event