Space Actions2026.8.0

Create new Space

Creates a Space and an initial membership for the authenticated user. Name must be 3–80 characters without URL-forming punctuation. Slug must be 4–50 chars (lowercase letters, numbers, hyphens). `type` must be `personal` or `business`.

POST/api/v1/spaces

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

None declared in this export.

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

userIdstring (uuid)Required: Authenticated user ID (must match token subject).
userFirstNamestringRequired: No field description supplied.
userLastNamestringRequired: No field description supplied.
userEmailstring (email)Required: No field description supplied.
namestringOptional: Space name, 3–80 characters without URL-forming punctuation.
slugstringOptional: Space slug, 4–50 chars; lowercase letters, numbers, hyphens.
countrystringOptional: Optional ISO-3166-1 alpha-2 code (e.g., DE, US).
contact_emailstring (email)Optional: Overrides contact email; defaults to userEmail.
typestringOptional: Allowed values: "personal", "business".
business_namestringOptional: Required if `type` is `business`; 5–100 chars.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request POST 'https://dashio.net/api/v1/spaces' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "userId": "4e6f9c2a-9a0d-43b2-9c2d-1f6b8f2a0a11",
  "userFirstName": "Alex",
  "userLastName": "Doe",
  "userEmail": "alex@example.com",
  "name": "Alex Personal Space",
  "slug": "alex-doe-space",
  "country": "DE",
  "type": "personal"
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "success": false,
  "spaceSlug": "<spaceSlug>",
  "spaceId": "<spaceId>"
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Space created.

successbooleanOptional: No field description supplied.
spaceSlugstringOptional: No field description supplied.
spaceIdstring (uuid)Optional: No field description supplied.