Tamio

Update a teammate

POST https://api.tamio.com/v2/teammates/update/{uuid}

Updates an existing teammate's profile, role, and permissions. When role is custom, the permissions object is required.

Path Parameters

uuid string*

UUID of the teammate to update.

Body Parameters

name string*

Updated first name of the teammate.

last_name string

Updated last name of the teammate.

role string*

Updated role for the teammate. Use custom for granular permissions.

accountantdevelopermarketerguestfulfilmentadministrator
country string*

Updated ISO country code.

permissions Permissions

Responses

200 Teammate updated

Teammate updated

status integer
teammate Teammate
400 Validation or business-logic error.
401 Missing or invalid API key
/teammates/update/{uuid}
1const response = await fetch("https://api.tamio.com/v2/teammates/update/{uuid}", {
2 method: "POST",
3 headers: {
4 "Authorization": "Bearer YOUR_API_KEY",
5 "Content-Type": "application/json"
6 },
7 body: JSON.stringify({
8 "name": "John",
9 "last_name": "Doe",
10 "role": "marketer",
11 "country": "GB",
12 "permissions": {
13 "account": {
14 "view": false,
15 "edit": false,
16 "remove": false
17 },
18 "billing": {
19 "view": false,
20 "edit": false
21 },
22 "keys": {
23 "view": false,
24 "edit": false,
25 "create": false,
26 "remove": false
27 },
28 "webhooks": {
29 "view": false,
30 "edit": false,
31 "create": false,
32 "remove": false
33 },
34 "logs": {
35 "view": false
36 },
37 "audit_trail": {
38 "view": false
39 },
40 "revenue_analytics": {
41 "view": false
42 },
43 "source_analytics": {
44 "view": false
45 },
46 "visitor_analytics": {
47 "view": false
48 },
49 "domains": {
50 "view": false,
51 "edit": false,
52 "create": false,
53 "remove": false
54 },
55 "taxes": {
56 "view": false,
57 "edit": false,
58 "create": false,
59 "remove": false
60 },
61 "teammates": {
62 "view": false,
63 "edit": false,
64 "create": false,
65 "remove": false
66 },
67 "reports": {
68 "view": false,
69 "edit": false
70 },
71 "sites": {
72 "view": false,
73 "edit": false,
74 "create": false,
75 "remove": false,
76 "publish": false,
77 "site": {}
78 },
79 "pages": {
80 "view": false,
81 "edit": false,
82 "create": false,
83 "remove": false,
84 "page": {}
85 },
86 "affiliate_programs": {
87 "view": false,
88 "edit": false,
89 "create": false,
90 "remove": false
91 },
92 "affiliates": {
93 "view": false,
94 "edit": false,
95 "remove": false
96 },
97 "affiliate_network": {
98 "view": false,
99 "edit": false
100 },
101 "payouts": {
102 "view": false,
103 "edit": false,
104 "create": false,
105 "remove": false
106 },
107 "payments": {
108 "view": false,
109 "edit": false,
110 "remove": false
111 },
112 "integrations": {
113 "view": false,
114 "edit": false,
115 "create": false,
116 "remove": false,
117 "publish": false,
118 "integration": {}
119 },
120 "invoices": {
121 "view": false,
122 "edit": false,
123 "create": false,
124 "remove": false
125 },
126 "subscriptions": {
127 "view": false,
128 "edit": false,
129 "remove": false
130 },
131 "instalment_plans": {
132 "view": false,
133 "edit": false,
134 "remove": false
135 },
136 "customers": {
137 "view": false,
138 "edit": false,
139 "create": false,
140 "remove": false,
141 "customer": {}
142 },
143 "subscribers": {
144 "view": false,
145 "edit": false,
146 "create": false,
147 "remove": false
148 },
149 "mailing_lists": {
150 "view": false,
151 "edit": false,
152 "create": false,
153 "remove": false,
154 "mailing_list": {}
155 },
156 "automations": {
157 "view": false,
158 "edit": false,
159 "create": false,
160 "remove": false
161 },
162 "discounts": {
163 "view": false,
164 "edit": false,
165 "create": false,
166 "remove": false
167 },
168 "email_templates": {
169 "view": false,
170 "edit": false,
171 "create": false,
172 "remove": false
173 },
174 "reviews": {
175 "view": false,
176 "edit": false,
177 "remove": false
178 },
179 "assets": {
180 "view": false,
181 "edit": false,
182 "create": false,
183 "remove": false
184 },
185 "products": {
186 "view": false,
187 "edit": false,
188 "create": false,
189 "remove": false,
190 "product": {}
191 },
192 "shippings": {
193 "view": false,
194 "edit": false,
195 "create": false,
196 "remove": false
197 },
198 "warehouses": {
199 "view": false,
200 "edit": false,
201 "create": false,
202 "remove": false,
203 "warehouse": {}
204 },
205 "support": {
206 "view": false,
207 "edit": false,
208 "create": false,
209 "remove": false
210 },
211 "clients": {
212 "view": false,
213 "edit": false,
214 "create": false,
215 "remove": false
216 },
217 "agency_billing_plans": {
218 "view": false,
219 "edit": false,
220 "create": false,
221 "remove": false
222 }
223 }
224 })
225});
226const data = await response.json();
Responses
{
  "status": 200,
  "teammate": {
    "id": "aaa14567-e89b-12d3-a456-426614174000",
    "object": "teammate",
    "email": "[email protected]",
    "name": "John",
    "last_name": "Doe",
    "country": "US",
    "last_login": 1711929600,
    "role": "developer",
    "verified": true,
    "permissions": {
      "products": {
        "view": true,
        "edit": true,
        "create": true,
        "remove": false
      },
      "invoices": {
        "view": true,
        "edit": false,
        "create": false,
        "remove": false
      }
    }
  }
}