{
"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"
}Update a space
Update a space’s settings by its ID. At least one field must be provided.
Payload Requirements
- At least one of
name,description,is_private,default_llm_integration,ml_models_enabled,gradient_start_color,gradient_end_color, ordefault_agent_runtimemust be provided. - Omitted fields keep their current value.
description,default_llm_integration, anddefault_agent_runtimecan be set tonullto clear them. - If
nameis provided, it must be unique within the organization. - System-managed fields (
id,created_at) cannot be modified.
{
"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
Service accounts may instead present an access token issued by an external identity provider (Microsoft Entra ID) when the account admin has configured that provider. Send it in the same header: Authorization: Bearer <access-token>.
Path Parameters
Body
Body containing space update parameters. At least one field must be provided.
Fields to update on a space. Omitted fields keep their current value, null
clears a clearable field, and an object value replaces the existing setting.
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.
Was this page helpful?