InboxKit
  1. Workspaces
InboxKit
  • Introduction
  • Account
    • Get account details
      GET
  • Workspaces
    • List workspaces
      GET
    • Get workspace details
      GET
    • Create workspace
      POST
    • Update workspace
      PUT
    • Delete workspace
      DELETE
    • Update workspace webhook
      POST
  • Domains
    • Search available domains
      POST
    • Check if domain is banned from registration
      GET
    • Check domain availability
      GET
    • Register domains
      POST
    • List domains
      GET
    • List assignable domains
      GET
    • Set DMARC policy
      POST
    • Remove DMARC policy
      DELETE
    • Remove domains
      POST
    • Set domain forwarding
      POST
    • Set email forwarding
      POST
    • Remove email forwarding
      DELETE
    • Set catch-all email
      POST
    • Remove catch-all email
      DELETE
    • Get nameservers for domain connection
      POST
    • Check nameservers propagation
      POST
  • Mailboxes
    • List mailboxes
      GET
    • Show mailbox credentials
      GET
    • Get mailbox details
      GET
    • Buy mailboxes
      POST
    • Check mailbox status
      POST
    • Cancel mailboxes
      POST
    • Update mailbox
      POST
    • Update mailbox profile picture
      POST
    • Generate TOTP
      GET
    • Change username
      POST
    • Change password
      POST
    • Check mailbox availability
      GET
  • DNS
    • Get DNS records
    • Add DNS records
    • Update DNS records
    • Delete DNS records
  • Sequencers
    • Export mailboxes status
    • List sequencer platforms
    • List sequencers
    • Export mailboxes
    • Add sequencer
    • Update sequencer
    • Delete sequencers
  • Billing
    • Get pricing plans
    • Get subscription details
    • Change subscription plan
    • Cancel subscription
    • Get wallet details
    • Add credits to wallet
    • Update auto top-up settings
    • Get billing portal link
  1. Workspaces

List workspaces

GET
https://api.inboxkit.com/v1/api/workspaces/list
Workspaces
Maintainer:Not configured
Get a list of all workspaces for the authenticated team
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.inboxkit.com/v1/api/workspaces/list'
Response Response Example
{
    "error": false,
    "message": "Workspaces fetched successfully",
    "workspaces": [
        {
            "uid": "ws_123456789",
            "name": "Marketing Team",
            "team": "string",
            "webhook_url": "https://example.com/webhook",
            "use_shared_billing": true,
            "domains": 5,
            "assigned_domains": 3,
            "assignable_domains": 2,
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z"
        }
    ]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Responses

🟢200OK
application/json
Workspaces retrieved successfully
Body
error
boolean 
optional
Example:
false
message
string 
optional
Example:
Workspaces fetched successfully
workspaces
array [object {10}] 
optional
List of workspaces
uid
string 
optional
Workspace unique identifier
Example:
ws_123456789
name
string 
optional
Workspace name
Example:
Marketing Team
team
string 
optional
Team reference ID
webhook_url
string  | null 
optional
Webhook URL for notifications
Example:
https://example.com/webhook
use_shared_billing
boolean 
optional
Whether to use shared billing
Example:
true
domains
integer 
optional
Total number of domains in workspace
Example:
5
assigned_domains
integer 
optional
Number of domains with assigned mailboxes
Example:
3
assignable_domains
integer 
optional
Number of domains available for assignment
Example:
2
created_at
string <date-time>
optional
Workspace creation timestamp
updated_at
string <date-time>
optional
Workspace last update timestamp
🟠401Unauthorized
🔴500Server Error
Modified at 2025-06-26 10:46:06
Previous
Get account details
Next
Get workspace details
Built with