Agency API Agency

Update a ticket category

POST https://api.tamio.com/v2/agency/ticket-categories/update/{uuid}

Updates an existing ticket category including title, language, subcategories, teammate assignment, and billing plan restrictions.

Path Parameters

uuid string*

Body Parameters

title string*

Updated title of the ticket category

language string*

Language code for the category content (e.g. en, de, fr)

automated_reply string

Auto-reply message sent when tickets are created in this category. Set to null to disable.

teammate_id string

UUID of the teammate to auto-assign tickets in this category to

billing_plans array of string

Billing plan UUIDs that have access to this category. Pass an empty array to allow all plans.

subcategories array of string

Subcategory names for organizing tickets within this category

Example

{
  "title": "Billing & Payments",
  "language": "en",
  "automated_reply": "Thank you for contacting us about billing.",
  "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
  "subcategories": [
    "Payment Failed",
    "Refund Request",
    "Subscription Issues"
  ]
}

Responses

200 Ticket category updated successfully

Ticket category updated successfully

status integer

ticket_category TicketCategory

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`400`	Category not found
`10253`	Agency domain not validated
`1002`	Teammate not found
`10322`	One or more billing plan UUIDs not found

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Create a ticket category

Delete a ticket category

/agency/ticket-categories/update/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/update/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "title": "Billing & Payments",
9     "language": "en",
10     "automated_reply": "Thank you for contacting us about billing.",
11     "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
12     "subcategories": [
13       "Payment Failed",
14       "Refund Request",
15       "Subscription Issues"
16     ]
17   })
18 });
19 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/agency/ticket-categories/update/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   title: "Billing & Payments",
16   language: "en",
17   automated_reply: "Thank you for contacting us about billing.",
18   teammate_id: "770e8400-e29b-41d4-a716-446655440000",
19   subcategories: ["Payment Failed", "Refund Request", "Subscription Issues"]
20 }.to_json
21 
22 response = https.request(request)
23 puts response.read_body

Responses

{
  "status": 200,
  "ticket_category": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "ticket_category",
    "title": "Billing Issues",
    "language": "en",
    "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
    "auto_reply": "Thank you for contacting us.",
    "subcategories": [
      "Payment Failed",
      "Refund Request"
    ],
    "billing_plans": [
      "550e8400-e29b-41d4-a716-446655440001",
      "550e8400-e29b-41d4-a716-446655440002"
    ],
    "created_at": 1700000000
  }
}

1	const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/update/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"title": "Billing & Payments",
9	"language": "en",
10	"automated_reply": "Thank you for contacting us about billing.",
11	"teammate_id": "770e8400-e29b-41d4-a716-446655440000",
12	"subcategories": [
13	"Payment Failed",
14	"Refund Request",
15	"Subscription Issues"
16	]
17	})
18	});
19	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/agency/ticket-categories/update/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	title: "Billing & Payments",
16	language: "en",
17	automated_reply: "Thank you for contacting us about billing.",
18	teammate_id: "770e8400-e29b-41d4-a716-446655440000",
19	subcategories: ["Payment Failed", "Refund Request", "Subscription Issues"]
20	}.to_json
21
22	response = https.request(request)
23	puts response.read_body