Create a space
curl --request POST \
--url https://api.arize.com/v2/spaces \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "LLM Evaluation",
"organization_id": "org_12345",
"description": "Space for evaluating LLM performance"
}
'import requests
url = "https://api.arize.com/v2/spaces"
payload = {
"name": "LLM Evaluation",
"organization_id": "org_12345",
"description": "Space for evaluating LLM performance"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'LLM Evaluation',
organization_id: 'org_12345',
description: 'Space for evaluating LLM performance'
})
};
fetch('https://api.arize.com/v2/spaces', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/spaces",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'LLM Evaluation',
'organization_id' => 'org_12345',
'description' => 'Space for evaluating LLM performance'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/spaces"
payload := strings.NewReader("{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.arize.com/v2/spaces")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/spaces")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}"
response = http.request(request)
puts response.read_body{
"id": "spc_001",
"organization_id": "QWNjb3VudE9yZ2FuaXphdGlvbjox",
"name": "LLM Evaluation",
"description": "Space for evaluating LLM performance",
"created_at": "2024-01-01T12:00:00Z",
"is_private": false,
"default_llm_integration": {
"integration_id": "TGxtSW50ZWdyYXRpb246MTIz",
"model_name": "claude-sonnet-4"
},
"ml_models_enabled": true,
"gradient_start_color": "#3B82F6",
"gradient_end_color": "#8B5CF6",
"default_agent_runtime": null
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 403,
"title": "Access forbidden",
"detail": "You do not have permission to access this resource.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#access-forbidden"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 409,
"title": "Resource conflict",
"detail": "A resource with the given identifier already exists.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict"
}{
"status": 422,
"title": "Unprocessable Entity",
"detail": "One or more fields failed validation.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#unprocessable-entity"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Spaces
Create a space
Create a new space within an organization.
Payload Requirements
nameandorganization_idare required.- The space name must be unique within the organization.
descriptionis optional and defaults to an empty string if omitted.- System-managed fields (
id,created_at) are generated automatically and rejected if provided.
This endpoint is in beta, read more here.
POST
/
v2
/
spaces
Create a space
curl --request POST \
--url https://api.arize.com/v2/spaces \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "LLM Evaluation",
"organization_id": "org_12345",
"description": "Space for evaluating LLM performance"
}
'import requests
url = "https://api.arize.com/v2/spaces"
payload = {
"name": "LLM Evaluation",
"organization_id": "org_12345",
"description": "Space for evaluating LLM performance"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'LLM Evaluation',
organization_id: 'org_12345',
description: 'Space for evaluating LLM performance'
})
};
fetch('https://api.arize.com/v2/spaces', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.arize.com/v2/spaces",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'LLM Evaluation',
'organization_id' => 'org_12345',
'description' => 'Space for evaluating LLM performance'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.arize.com/v2/spaces"
payload := strings.NewReader("{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.arize.com/v2/spaces")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/spaces")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"LLM Evaluation\",\n \"organization_id\": \"org_12345\",\n \"description\": \"Space for evaluating LLM performance\"\n}"
response = http.request(request)
puts response.read_body{
"id": "spc_001",
"organization_id": "QWNjb3VudE9yZ2FuaXphdGlvbjox",
"name": "LLM Evaluation",
"description": "Space for evaluating LLM performance",
"created_at": "2024-01-01T12:00:00Z",
"is_private": false,
"default_llm_integration": {
"integration_id": "TGxtSW50ZWdyYXRpb246MTIz",
"model_name": "claude-sonnet-4"
},
"ml_models_enabled": true,
"gradient_start_color": "#3B82F6",
"gradient_end_color": "#8B5CF6",
"default_agent_runtime": null
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 403,
"title": "Access forbidden",
"detail": "You do not have permission to access this resource.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#access-forbidden"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 409,
"title": "Resource conflict",
"detail": "A resource with the given identifier already exists.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict"
}{
"status": 422,
"title": "Unprocessable Entity",
"detail": "One or more fields failed validation.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#unprocessable-entity"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Authorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Body
application/json
Body containing space creation parameters
Name of the space (must be unique within the organization)
Maximum string length:
255The unique identifier of the organization to create the space in
Example:
"RW50aXR5OjEyMzQ1"
A brief description of the space's purpose. Defaults to an empty string if omitted.
Maximum string length:
1000Whether to create the space as private. Private spaces are only visible
to their members and account/org/space admins. Defaults to false
(public) if omitted.
Response
A space object
A space is a container within an organization for grouping related projects, datasets, and experiments. Spaces enable team collaboration or isolated experimentation with role-based access control.
Unique identifier for the space
Name of the space
A brief description of the space's purpose
Timestamp for when the space was created
Whether the space is private. Private spaces are only visible to their members and account/org/space admins.
The unique identifier of the organization that contains the space. Older server versions may omit this field.
Example:
"RW50aXR5OjEyMzQ1"
The default language model integration and model for the space.
Show child attributes
Show child attributes
Whether machine learning models are enabled for the space.
The first color in the gradient used for the space's avatar.
The second color in the gradient used for the space's avatar.
The default agent runtime integration for the space.
Show child attributes
Show child attributes
Was this page helpful?