curl --request POST \
--url https://api.arize.com/v2/tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
'import requests
url = "https://api.arize.com/v2/tags"
payload = {
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
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: 'production',
description: 'Resources serving production traffic',
color: 'GREEN',
space_id: 'U3BhY2U6MTIzNDU='
})
};
fetch('https://api.arize.com/v2/tags', 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/tags",
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' => 'production',
'description' => 'Resources serving production traffic',
'color' => 'GREEN',
'space_id' => 'U3BhY2U6MTIzNDU='
]),
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/tags"
payload := strings.NewReader("{\n \"name\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\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/tags")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/tags")
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\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\n}"
response = http.request(request)
puts response.read_body{
"id": "VGFnOjEyMzQ1",
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU=",
"created_at": "2026-01-01T12:00:00Z",
"updated_at": "2026-01-01T12:00:00Z"
}{
"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"
}Create a tag
Create a tag in a space. Tags are shared within the space and can then be attached to resources across the platform.
Payload Requirements
nameis required, must be non-empty after trimming, and at most 100 characters.namemust be unique within the space, compared case-insensitively — a space that already containsProductioncannot also containproduction. A collision returns409.space_idis required and must be a space the caller can create tags in.color, when provided, must be one of theTagColorvalues.- System-managed fields (
id,created_at,updated_at) are rejected on input. - Unrecognized fields are rejected with
400rather than ignored.
Valid example
{
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
Invalid example (name collides with an existing tag, differing only in case)
Request:
{
"name": "Production",
"space_id": "U3BhY2U6MTIzNDU="
}
Response:
{
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-conflict",
"title": "Conflict",
"status": 409,
"detail": "A tag with this name already exists in the space",
"request_id": "req_01HZY6X8E7"
}
curl --request POST \
--url https://api.arize.com/v2/tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
'import requests
url = "https://api.arize.com/v2/tags"
payload = {
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU="
}
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: 'production',
description: 'Resources serving production traffic',
color: 'GREEN',
space_id: 'U3BhY2U6MTIzNDU='
})
};
fetch('https://api.arize.com/v2/tags', 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/tags",
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' => 'production',
'description' => 'Resources serving production traffic',
'color' => 'GREEN',
'space_id' => 'U3BhY2U6MTIzNDU='
]),
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/tags"
payload := strings.NewReader("{\n \"name\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\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/tags")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/tags")
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\": \"production\",\n \"description\": \"Resources serving production traffic\",\n \"color\": \"GREEN\",\n \"space_id\": \"U3BhY2U6MTIzNDU=\"\n}"
response = http.request(request)
puts response.read_body{
"id": "VGFnOjEyMzQ1",
"name": "production",
"description": "Resources serving production traffic",
"color": "GREEN",
"space_id": "U3BhY2U6MTIzNDU=",
"created_at": "2026-01-01T12:00:00Z",
"updated_at": "2026-01-01T12:00:00Z"
}{
"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>.
Body
Body containing tag creation parameters
Response
A tag object
A tag is a reusable label defined once per space and attached to many resources across the platform, so the same vocabulary can be applied to projects, datasets, prompts, and more.
Tags are shared. Renaming a tag changes it everywhere it appears, and deleting a tag detaches it from every resource it was attached to.
Was this page helpful?