Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Deskcrew Io Billing API
version: 1.0.0
contact:
name: DeskCrew support
url: https://deskcrew.io/board/deskcrew
email: hello@deskcrew.io
description: 'Operations tagged Billing across 2 of this provider''s published API definitions: openapi.json, deskcrew-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://deskcrew.io
security:
- bearerAuth: []
tags:
- name: Billing
paths:
/api/v1/billing:
get:
summary: Plan and billing source (native apps)
description: The plan, where it comes from (web or Apple), when an Apple subscription renews, and whether an in-app purchase is allowed. Needs the tickets:read scope. Requires the `tickets:read` scope.
operationId: get_api_v1_billing
security:
- bearerAuth: []
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Billing
servers:
- url: https://deskcrew.io
/api/v1/billing/apple:
post:
summary: Apply an App Store subscription to the workspace
description: Takes the StoreKit 2 signed transaction; the server verifies it and sets the plan. Admins only, and refused while a web subscription is live. Needs the tickets:write scope. Requires the `tickets:write` scope.
operationId: post_api_v1_billing_apple
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
description: 'signedTransaction: string, required'
responses:
'200':
description: Success
'401':
description: Missing or invalid API key
'403':
description: The key does not hold the required scope
'404':
description: Not found in this workspace
'429':
description: Rate limited
tags:
- Billing
servers:
- url: https://deskcrew.io
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: A workspace API key that starts with dk_, or a signed-in person's session token from the DeskCrew apps.
x-refined-from:
- openapi.json
- deskcrew-io-openapi.json
x-scopes:
- tickets:read
- tickets:write
- tickets:reply
- issues:read
- issues:write
- changelog:read
- changelog:write
- customers:read
- kb:read
- kb:write
- webhooks:manage
- errors:write
- bounties:manage
- bounties:read