{ "info": { "_postman_id": "6c315d05-33d7-4cff-843e-0b217c5a2d81", "name": "TeamCity REST Agent Pools Users API", "description": "The TeamCity REST API provides programmatic access to JetBrains TeamCity continuous integration and deployment server. It allows you to manage projects, build configurations, builds, agents, users, VCS roots, changes, tests, and other TeamCity resources.\n\nContact Support:\n Name: JetBrains\n Email: teamcity-support@jetbrains.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T03:09:08.000Z", "updatedAt": "2026-07-28T03:09:08.000Z", "lastUpdatedBy": "35240", "uid": "35240-6c315d05-33d7-4cff-843e-0b217c5a2d81" }, "item": [ { "name": "users", "item": [ { "name": "{userLocator}", "item": [ { "name": "Get User", "id": "5072bf28-53c2-4164-88c5-5cc3988fc238", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/users/:userLocator?fields=", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "query": [ { "description": "Fields to include in the response (for partial responses)", "key": "fields", "value": "" } ], "variable": [ { "id": "37f6f422-e0a8-452c-88c2-4415ec5a2b0c", "key": "userLocator", "value": "", "description": "(Required) " } ] }, "description": "Returns details of a specific user." }, "response": [ { "id": "a49813f2-40ac-494e-8b31-985249207d11", "name": "Successful response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/users/:userLocator?fields=", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "query": [ { "description": "Fields to include in the response (for partial responses)", "key": "fields", "value": "" } ], "variable": [ { "key": "userLocator" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-a49813f2-40ac-494e-8b31-985249207d11" } ], "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-5072bf28-53c2-4164-88c5-5cc3988fc238" }, { "name": "Update User", "id": "d618790b-d3b5-4081-a1ec-e92002973b86", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:userLocator", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "variable": [ { "id": "03648781-f857-4857-9ab3-ff3e4aa8f37a", "key": "userLocator", "value": "", "description": "(Required) " } ] }, "description": "Updates an existing user." }, "response": [ { "id": "a418e2e9-e610-4658-a40b-0a749f7319cd", "name": "User updated successfully", "originalRequest": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users/:userLocator", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "variable": [ { "key": "userLocator" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-a418e2e9-e610-4658-a40b-0a749f7319cd" } ], "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-d618790b-d3b5-4081-a1ec-e92002973b86" }, { "name": "Delete User", "id": "22dac91b-b405-4fe6-a812-1b3599209b69", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/users/:userLocator", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "variable": [ { "id": "ed1fd989-7269-4ec4-a80b-5beb5c4bc662", "key": "userLocator", "value": "", "description": "(Required) " } ] }, "description": "Deletes a specific user." }, "response": [ { "id": "a70643a9-5d22-44e2-9c07-fe73a5f5f310", "name": "User deleted successfully", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/users/:userLocator", "host": [ "{{baseUrl}}" ], "path": [ "users", ":userLocator" ], "variable": [ { "key": "userLocator" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-a70643a9-5d22-44e2-9c07-fe73a5f5f310" } ], "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-22dac91b-b405-4fe6-a812-1b3599209b69" } ], "id": "c79c6191-3236-48be-b5f3-666c72f503ec", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-c79c6191-3236-48be-b5f3-666c72f503ec" }, { "name": "Get All Users", "id": "c06ae2d1-a853-4290-86ef-b512b3ad6182", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/users?fields=", "host": [ "{{baseUrl}}" ], "path": [ "users" ], "query": [ { "description": "Fields to include in the response (for partial responses)", "key": "fields", "value": "" } ] }, "description": "Returns a list of all users." }, "response": [ { "id": "f0fd681b-6839-4a2a-b382-263ea78cc50e", "name": "Successful response", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/users?fields=", "host": [ "{{baseUrl}}" ], "path": [ "users" ], "query": [ { "description": "Fields to include in the response (for partial responses)", "key": "fields", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"count\": \"\",\n \"user\": [\n {\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n },\n {\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n }\n ]\n}", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-f0fd681b-6839-4a2a-b382-263ea78cc50e" } ], "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-c06ae2d1-a853-4290-86ef-b512b3ad6182" }, { "name": "Create User", "id": "9dd225ff-034d-4bb2-a85f-9fd6defa1464", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] }, "description": "Creates a new user." }, "response": [ { "id": "915d9943-53ba-4372-98d4-39299b85f438", "name": "User created successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/users", "host": [ "{{baseUrl}}" ], "path": [ "users" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"username\": \"\",\n \"name\": \"\",\n \"email\": \"\",\n \"href\": \"\",\n \"lastLogin\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n },\n \"groups\": {\n \"count\": \"\",\n \"group\": [\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n },\n {\n \"key\": \"\",\n \"name\": \"\",\n \"description\": \"\",\n \"href\": \"\",\n \"roles\": {\n \"role\": [\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n },\n {\n \"roleId\": \"\",\n \"scope\": \"\",\n \"href\": \"\"\n }\n ]\n }\n }\n ]\n }\n}", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-915d9943-53ba-4372-98d4-39299b85f438" } ], "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-9dd225ff-034d-4bb2-a85f-9fd6defa1464" } ], "id": "6b9ebcc2-10cd-490d-99f4-f43eefc78e26", "createdAt": "2026-07-28T03:09:09.000Z", "updatedAt": "2026-07-28T03:09:09.000Z", "uid": "35240-6b9ebcc2-10cd-490d-99f4-f43eefc78e26" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "server", "value": "teamcity.example.com" }, { "key": "baseUrl", "value": "https://{{server}}/app/rest" } ] }