{ "info": { "_postman_id": "ae72df07-518b-4b04-939c-7723bc62403f", "name": "Rollbar Deployment Access Tokens Deploys API", "description": "The Rollbar Deployment API allows developers to notify Rollbar of application deployments and releases. By reporting deploys, teams can correlate error spikes with specific releases, track which code version introduced a bug, and automatically resolve items that were fixed in a deploy. The API accepts deployment metadata such as revision, environment, and rollbar_username, and integrates with CI/CD pipelines to provide continuous visibility into how deployments affect application stability.\n\nContact Support:\n Name: Rollbar Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:48:57.000Z", "updatedAt": "2026-07-28T02:48:57.000Z", "lastUpdatedBy": "35240", "uid": "35240-ae72df07-518b-4b04-939c-7723bc62403f" }, "item": [ { "name": "deploy", "item": [ { "name": "{deployId}", "item": [ { "name": "Get a Deploy", "id": "6bbccc19-eee5-4785-909a-5123be823b27", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "id": "1faf57dd-93b0-4d74-81d6-2facda03485f", "key": "deployId", "value": "", "description": "(Required) The ID of the deployment." } ] }, "description": "Returns information about a specific deployment by its deploy ID." }, "response": [ { "id": "1173da42-8841-4009-8c3a-bd0b45a914da", "name": "Deploy details", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"err\": \"\",\n \"result\": {\n \"id\": \"\",\n \"project_id\": \"\",\n \"environment\": \"\",\n \"revision\": \"\",\n \"local_username\": \"\",\n \"rollbar_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\",\n \"start_time\": \"\",\n \"finish_time\": \"\",\n \"user_id\": \"\"\n }\n}", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-1173da42-8841-4009-8c3a-bd0b45a914da" }, { "id": "e1b85b8c-cd0c-4b27-b10b-ee511845e5bb", "name": "Unauthorized", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-e1b85b8c-cd0c-4b27-b10b-ee511845e5bb" }, { "id": "46b864a4-5a51-4a0c-a432-4d92a70bb55f", "name": "Deploy not found", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-46b864a4-5a51-4a0c-a432-4d92a70bb55f" } ], "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-6bbccc19-eee5-4785-909a-5123be823b27" }, { "name": "Update a Deploy", "id": "76de71f1-900c-46e4-82b9-26eaff8be2ea", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"timed_out\",\n \"comment\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "id": "07a26347-79fd-431c-82d1-54a641aa8676", "key": "deployId", "value": "", "description": "(Required) The ID of the deployment." } ] }, "description": "Updates the status of a deployment. Commonly used to mark a deploy as succeeded or failed after it was initially reported with a started status." }, "response": [ { "id": "e57d6fda-c6a9-49ce-ac35-64c0351338b8", "name": "Deploy updated", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"timed_out\",\n \"comment\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"err\": \"\",\n \"result\": {\n \"id\": \"\",\n \"project_id\": \"\",\n \"environment\": \"\",\n \"revision\": \"\",\n \"local_username\": \"\",\n \"rollbar_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\",\n \"start_time\": \"\",\n \"finish_time\": \"\",\n \"user_id\": \"\"\n }\n}", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-e57d6fda-c6a9-49ce-ac35-64c0351338b8" }, { "id": "01879908-18e8-4240-8c7a-7f9cd144170b", "name": "Unauthorized", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"timed_out\",\n \"comment\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-01879908-18e8-4240-8c7a-7f9cd144170b" }, { "id": "3992a692-56ed-4c0f-a134-231a63ea05df", "name": "Deploy not found", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"timed_out\",\n \"comment\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-3992a692-56ed-4c0f-a134-231a63ea05df" }, { "id": "1e76433d-1f8c-4db5-af01-893cac1aa5e0", "name": "Unprocessable entity", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"status\": \"timed_out\",\n \"comment\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy/:deployId", "host": [ "{{baseUrl}}" ], "path": [ "deploy", ":deployId" ], "variable": [ { "key": "deployId" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-1e76433d-1f8c-4db5-af01-893cac1aa5e0" } ], "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-76de71f1-900c-46e4-82b9-26eaff8be2ea" } ], "id": "17f2dc37-35d6-41bc-a790-47e2c323dd22", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-17f2dc37-35d6-41bc-a790-47e2c323dd22" }, { "name": "Create a Deploy", "id": "8f8c9946-b95d-4823-918e-19252219812b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"environment\": \"\",\n \"revision\": \"\",\n \"rollbar_username\": \"\",\n \"local_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy", "host": [ "{{baseUrl}}" ], "path": [ "deploy" ] }, "description": "Reports a new deployment to Rollbar. This allows Rollbar to correlate error data with specific code releases. The deploy can be created with a status of started and later updated to succeeded or failed using the PATCH endpoint." }, "response": [ { "id": "e0bcc687-aa76-462a-8a29-ccd0fb7f72be", "name": "Deploy 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: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"environment\": \"\",\n \"revision\": \"\",\n \"rollbar_username\": \"\",\n \"local_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy", "host": [ "{{baseUrl}}" ], "path": [ "deploy" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"err\": \"\",\n \"result\": {\n \"deploy_id\": \"\"\n }\n}", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-e0bcc687-aa76-462a-8a29-ccd0fb7f72be" }, { "id": "6472458e-6cda-4be0-bd4b-d40a75e0de6a", "name": "Bad request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"environment\": \"\",\n \"revision\": \"\",\n \"rollbar_username\": \"\",\n \"local_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy", "host": [ "{{baseUrl}}" ], "path": [ "deploy" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-6472458e-6cda-4be0-bd4b-d40a75e0de6a" }, { "id": "4a39b354-2c14-4379-b3d1-fc2ff1b5e494", "name": "Unauthorized", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"environment\": \"\",\n \"revision\": \"\",\n \"rollbar_username\": \"\",\n \"local_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy", "host": [ "{{baseUrl}}" ], "path": [ "deploy" ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-4a39b354-2c14-4379-b3d1-fc2ff1b5e494" }, { "id": "36fff91a-a6a3-424a-a9fd-f1b0dc516c51", "name": "Unprocessable entity", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"environment\": \"\",\n \"revision\": \"\",\n \"rollbar_username\": \"\",\n \"local_username\": \"\",\n \"comment\": \"\",\n \"status\": \"succeeded\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/deploy", "host": [ "{{baseUrl}}" ], "path": [ "deploy" ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-36fff91a-a6a3-424a-a9fd-f1b0dc516c51" } ], "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-8f8c9946-b95d-4823-918e-19252219812b" } ], "id": "274a5b7b-3714-4325-bf89-58f020bc46c9", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-274a5b7b-3714-4325-bf89-58f020bc46c9" }, { "name": "deploys", "item": [ { "name": "List Deploys", "id": "97a4ba78-e75e-47ab-892b-f3cd5549521a", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/deploys?page=1&environment=", "host": [ "{{baseUrl}}" ], "path": [ "deploys" ], "query": [ { "description": "Page number for pagination. Defaults to 1.", "key": "page", "value": "1" }, { "description": "Filter deploys by environment name.", "key": "environment", "value": "" } ] }, "description": "Returns a paginated list of deployments for the project, ordered by most recent first. Supports filtering by environment." }, "response": [ { "id": "de45d212-fba9-4187-b364-0f2aef8542a9", "name": "List of deploys", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "url": { "raw": "{{baseUrl}}/deploys?page=1&environment=", "host": [ "{{baseUrl}}" ], "path": [ "deploys" ], "query": [ { "description": "Page number for pagination. Defaults to 1.", "key": "page", "value": "1" }, { "description": "Filter deploys by environment name.", "key": "environment", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"err\": \"\",\n \"result\": {\n \"deploys\": [\n {\n \"id\": \"\",\n \"project_id\": \"\",\n \"environment\": \"\",\n \"revision\": \"\",\n \"local_username\": \"\",\n \"rollbar_username\": \"\",\n \"comment\": \"\",\n \"status\": \"failed\",\n \"start_time\": \"\",\n \"finish_time\": \"\",\n \"user_id\": \"\"\n },\n {\n \"id\": \"\",\n \"project_id\": \"\",\n \"environment\": \"\",\n \"revision\": \"\",\n \"local_username\": \"\",\n \"rollbar_username\": \"\",\n \"comment\": \"\",\n \"status\": \"started\",\n \"start_time\": \"\",\n \"finish_time\": \"\",\n \"user_id\": \"\"\n }\n ],\n \"page\": \"\"\n }\n}", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-de45d212-fba9-4187-b364-0f2aef8542a9" }, { "id": "b6775c76-dfb1-41c5-8483-92a3dda207c3", "name": "Unauthorized", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "X-Rollbar-Access-Token", "value": "" } ], "url": { "raw": "{{baseUrl}}/deploys?page=1&environment=", "host": [ "{{baseUrl}}" ], "path": [ "deploys" ], "query": [ { "description": "Page number for pagination. Defaults to 1.", "key": "page", "value": "1" }, { "description": "Filter deploys by environment name.", "key": "environment", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-b6775c76-dfb1-41c5-8483-92a3dda207c3" } ], "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-97a4ba78-e75e-47ab-892b-f3cd5549521a" } ], "id": "87674d7a-5078-401f-ab82-1f2e057d9097", "createdAt": "2026-07-28T02:48:58.000Z", "updatedAt": "2026-07-28T02:48:58.000Z", "uid": "35240-87674d7a-5078-401f-ab82-1f2e057d9097" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Rollbar-Access-Token", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.rollbar.com/api/1" } ] }