Remove App

DELETE

/subscription/apps/:appSlug

DELETE

/api/v1/subscription/apps/:appSlug

curl -X DELETE https://api.taktoria.com/api/v1/subscription/apps/appSlug \
     -H "Authorization: Bearer <token>"

{
  "billingInterval": "month",
  "annualAvailable": true,
  "billingAvailable": true,
  "autoJoin": true,
  "autoGrowSeats": true,
  "apps": [
    {
      "appSlug": "appSlug",
      "billing": "per_seat",
      "cancelAtPeriodEnd": true,
      "seatsAssigned": 1,
      "waiting": 1,
      "growsAsPeopleJoin": true,
      "minSeats": 1,
      "status": "TRIALING",
      "seatsPaid": 1,
      "capacity": 1,
      "hostSeats": 1,
      "minCapacity": 1,
      "trialEndsAt": "2024-01-15T09:30:00Z",
      "currentPeriodEnd": "2024-01-15T09:30:00Z"
    },
    {
      "appSlug": "appSlug",
      "billing": "per_seat",
      "cancelAtPeriodEnd": true,
      "seatsAssigned": 1,
      "waiting": 1,
      "growsAsPeopleJoin": true,
      "minSeats": 1,
      "status": "TRIALING",
      "seatsPaid": 1,
      "capacity": 1,
      "hostSeats": 1,
      "minCapacity": 1,
      "trialEndsAt": "2024-01-15T09:30:00Z",
      "currentPeriodEnd": "2024-01-15T09:30:00Z"
    }
  ],
  "paymentIssue": "unpaid",
  "cardAddedAt": "2024-01-15T09:30:00Z"
}

Take one app off the subscription, as unticking it on the billing page does: it comes off now, with its unused time credited, and the last app taken off cancels the subscription at the end of the period. Its waiting list goes once it is off. The only way the API removes an app. Requires billing:write. 404 not_subscribed when the workspace does not have it.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

appSlugstringRequired

Response

This endpoint returns an object.

billingIntervalenum

How often the subscription is billed. Every line of one subscription shares it.

Allowed values:

annualAvailableboolean

Whether yearly billing can be chosen here. It needs a yearly price for every app.

billingAvailableboolean

Whether this installation can take a subscription at all. When it cannot, updateSubscription answers 409 billing_unavailable.

autoJoinboolean

Whether any verified email domain has autoJoin on, so people can join without an invitation.

autoGrowSeatsboolean

The workspace’s autoGrowSeats (PATCH /organization): with autoJoin, whether full apps grow for newcomers or they wait.

appslist of objects

paymentIssueenumOptional

Absent (null) while every payment has gone through.

Allowed values:

cardAddedAtdatetimeOptional

When a card was put on file, by a completed Checkout or in the billing portal. Absent with no card, or once it is removed. Set, the workspace has subscribed: its trials carry on into the paid plan, and the app stops showing the trial banner.

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

502

Upstream Error