---
title: "Crée un espace client. Refusé avec le code `space_limit_reached` si la formule est pleine."
method: POST
path: "/api/v1/spaces"
tags: ["spaces"]
---

# Crée un espace client. Refusé avec le code \`space_limit_reached\` si la formule est pleine.

`POST /api/v1/spaces`

## Request

- Base URL: `https://subtraq.co`
- URL: `https://subtraq.co/api/v1/spaces`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required: Nom affiché, par exemple « Maison Lartigue ».
  - `slug` string: Raccourci dans les URL. Déduit du nom s'il est omis.

## Response `200`

Succès.

## Other responses

- `201`: Créé.
- `400`: Paramètres invalides.
- `401`: Clé absente ou révoquée.
- `402`: Quota de la formule atteint.
- `403`: La clé n'a pas le droit demandé.
- `404`: Introuvable dans ce compte.
- `409`: Conflit — un raccourci déjà pris, par exemple.

---

[API](https://skmtc.dev/subtraq/apis/subtraq-api.md) · [All operations](https://skmtc.dev/subtraq/apis/subtraq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subtraq/apis/subtraq-api/revisions/1a3dacdd7d28?raw)