---
title: Spaces API
description: "Use the AI Inbx spaces API. Browse endpoints, request parameters, response schemas, and code examples for your integration."
sidebar:
  label: Overview
---

{/* Generated by scripts/openapi.ts from the shared API contract. */}

Group a workspace's domains, mailboxes and mail by customer. Optional: a workspace that is not a platform never needs one.

## Endpoints

| Method | Operation | Path |
| --- | --- | --- |
| `GET` | [List spaces](/api/endpoints/spaces/list-spaces) | `/spaces` |
| `POST` | [Create a space](/api/endpoints/spaces/create-space) | `/spaces` |
| `GET` | [Retrieve a space](/api/endpoints/spaces/retrieve-space) | `/spaces/{space_id}` |
| `DELETE` | [Delete a space](/api/endpoints/spaces/delete-space) | `/spaces/{space_id}` |
| `PATCH` | [Update a space](/api/endpoints/spaces/update-space) | `/spaces/{space_id}` |

## Request essentials [#request-essentials]

Use `https://api.aiinbx.com/api/v2` as the base URL and send your API key in `Authorization: Bearer <key>`. Keep credentials on your server.

See [Authentication](/authentication) for scopes, [Conventions](/reference/conventions) for pagination and idempotency, and [Errors](/reference/errors) for recovery guidance. Each endpoint page includes its parameters, response schemas, and copyable curl, JavaScript, and Python examples.