Attach tags to a project

curl --request POST \
  --url https://api.arize.com/v2/projects/{project_id}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tag_ids": [
    "VGFnOjEyMzQ1",
    "VGFnOjEyMzQ2"
  ]
}
'

import requests

url = "https://api.arize.com/v2/projects/{project_id}/tags"

payload = { "tag_ids": ["VGFnOjEyMzQ1", "VGFnOjEyMzQ2"] }
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({tag_ids: ['VGFnOjEyMzQ1', 'VGFnOjEyMzQ2']})
};

fetch('https://api.arize.com/v2/projects/{project_id}/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/projects/{project_id}/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([
    'tag_ids' => [
        'VGFnOjEyMzQ1',
        'VGFnOjEyMzQ2'
    ]
  ]),
  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/projects/{project_id}/tags"

	payload := strings.NewReader("{\n  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\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/projects/{project_id}/tags")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.arize.com/v2/projects/{project_id}/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  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "tags": [
    {
      "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-03T09:30:00Z"
    },
    {
      "id": "VGFnOjEyMzQ2",
      "name": "needs-review",
      "description": null,
      "color": null,
      "space_id": "U3BhY2U6MTIzNDU=",
      "created_at": "2026-01-01T12:00:00Z",
      "updated_at": "2026-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "has_more": false
  }
}

Projects

Attach tags to a project

Attach one or more existing tags to a project.

Payload Requirements

tag_ids is required and must contain between 1 and 100 tag IDs.
Every tag must already exist and belong to the same space as the project. A tag from another space returns 422.
Attaching a tag that is already attached is idempotent, so the same request can be retried safely.
Unrecognized fields are rejected with 422 rather than ignored.

Returns 200 with the project’s complete tag list, not 201: attaching an existing tag creates no new resource.

Valid example

{
  "tag_ids": ["VGFnOjEyMzQ1", "VGFnOjEyMzQ2"]
}

Invalid example (empty list)

{
  "tag_ids": []
}

{
  "type": "https://arize.com/docs/ax/rest-reference/errors#validation-error",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "tag_ids must contain at least 1 tag ID",
  "request_id": "req_01HZY6X8E7"
}

This endpoint is in alpha, read more here.

POST

projects

{project_id}

tags

Attach tags to a project

curl --request POST \
  --url https://api.arize.com/v2/projects/{project_id}/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tag_ids": [
    "VGFnOjEyMzQ1",
    "VGFnOjEyMzQ2"
  ]
}
'

import requests

url = "https://api.arize.com/v2/projects/{project_id}/tags"

payload = { "tag_ids": ["VGFnOjEyMzQ1", "VGFnOjEyMzQ2"] }
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({tag_ids: ['VGFnOjEyMzQ1', 'VGFnOjEyMzQ2']})
};

fetch('https://api.arize.com/v2/projects/{project_id}/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/projects/{project_id}/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([
    'tag_ids' => [
        'VGFnOjEyMzQ1',
        'VGFnOjEyMzQ2'
    ]
  ]),
  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/projects/{project_id}/tags"

	payload := strings.NewReader("{\n  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\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/projects/{project_id}/tags")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.arize.com/v2/projects/{project_id}/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  \"tag_ids\": [\n    \"VGFnOjEyMzQ1\",\n    \"VGFnOjEyMzQ2\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "tags": [
    {
      "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-03T09:30:00Z"
    },
    {
      "id": "VGFnOjEyMzQ2",
      "name": "needs-review",
      "description": null,
      "color": null,
      "space_id": "U3BhY2U6MTIzNDU=",
      "created_at": "2026-01-01T12:00:00Z",
      "updated_at": "2026-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "has_more": false
  }
}

Authorizations

Authorization

string

header

required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

project_id

string

required

The unique project identifier (base64) A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Body

application/json

Body containing the IDs of the tags to attach to the resource

tag_ids

string[]

required

IDs of the tags to attach. Up to 100 per request. Tags must belong to the same space as the resource. Attaching a tag that is already attached is idempotent rather than an error, so the same request can be retried safely.

Required array length: 1 - 100 elements

A universally unique identifier (base64-encoded opaque string).

Response

Returns the tags attached to the resource

Skills

API reference

API clients

Attach tags to a project

Authorizations

Path Parameters

Body

Response