{ "info": { "_postman_id": "23374a9f-3f08-4c46-91db-625fa93faa04", "name": "AWS X-Ray CreateGroup TraceSegments API", "description": "Amazon Web Services X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces.\n\nContact Support:\n Name: Mike Ralphson\n Email: mike.ralphson@gmail.com", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "lastUpdatedBy": "35240", "uid": "35240-23374a9f-3f08-4c46-91db-625fa93faa04" }, "item": [ { "name": "TraceSegments", "item": [ { "name": "Amazon X-Ray Put Trace Segments", "id": "079bec6a-e530-46af-9360-76b5e7dcfed8", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "X-Amz-Content-Sha256", "value": "" }, { "key": "X-Amz-Date", "value": "" }, { "key": "X-Amz-Algorithm", "value": "" }, { "key": "X-Amz-Credential", "value": "" }, { "key": "X-Amz-Security-Token", "value": "" }, { "key": "X-Amz-Signature", "value": "" }, { "key": "X-Amz-SignedHeaders", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"TraceSegmentDocuments\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/TraceSegments", "host": [ "{{baseUrl}}" ], "path": [ "TraceSegments" ] }, "description": "

Uploads segment documents to Amazon Web Services X-Ray. The X-Ray SDK generates segment documents and sends them to the X-Ray daemon, which uploads them in batches. A segment document can be a completed segment, an in-progress segment, or an array of subsegments.

Segments must include the following fields. For the full segment document schema, see Amazon Web Services X-Ray Segment Documents in the Amazon Web Services X-Ray Developer Guide.

Required segment document fields

  • name - The name of the service that handled the request.

  • id - A 64-bit identifier for the segment, unique among segments in the same trace, in 16 hexadecimal digits.

  • trace_id - A unique identifier that connects all segments and subsegments originating from a single client request.

  • start_time - Time the segment or subsegment was created, in floating point seconds in epoch time, accurate to milliseconds. For example, 1480615200.010 or 1.480615200010E9.

  • end_time - Time the segment or subsegment was closed. For example, 1480615200.090 or 1.480615200090E9. Specify either an end_time or in_progress.

  • in_progress - Set to true instead of specifying an end_time to record that a segment has been started, but is not complete. Send an in-progress segment when your application receives a request that will take a long time to serve, to trace that the request was received. When the response is sent, send the complete segment to overwrite the in-progress segment.

A trace_id consists of three numbers separated by hyphens. For example, 1-58406520-a006649127e371903a2de979. This includes:

Trace ID Format

  • The version number, for instance, 1.

  • The time of the original request, in Unix epoch time, in 8 hexadecimal digits. For example, 10:00AM December 2nd, 2016 PST in epoch time is 1480615200 seconds, or 58406520 in hexadecimal.

  • A 96-bit identifier for the trace, globally unique, in 24 hexadecimal digits.

" }, "response": [ { "id": "2eb28e16-1f46-4ff5-93e7-2d0923d380d5", "name": "Success", "originalRequest": { "method": "POST", "header": [ { "key": "X-Amz-Content-Sha256", "value": "" }, { "key": "X-Amz-Date", "value": "" }, { "key": "X-Amz-Algorithm", "value": "" }, { "key": "X-Amz-Credential", "value": "" }, { "key": "X-Amz-Security-Token", "value": "" }, { "key": "X-Amz-Signature", "value": "" }, { "key": "X-Amz-SignedHeaders", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"TraceSegmentDocuments\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/TraceSegments", "host": [ "{{baseUrl}}" ], "path": [ "TraceSegments" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"UnprocessedTraceSegments\": [\n {\n \"Id\": \"\",\n \"ErrorCode\": \"\",\n \"Message\": \"\"\n },\n {\n \"Id\": \"\",\n \"ErrorCode\": \"\",\n \"Message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "uid": "35240-2eb28e16-1f46-4ff5-93e7-2d0923d380d5" }, { "id": "45925d4f-ed31-4f3d-bb05-89afac32d9ce", "name": "InvalidRequestException", "originalRequest": { "method": "POST", "header": [ { "key": "X-Amz-Content-Sha256", "value": "" }, { "key": "X-Amz-Date", "value": "" }, { "key": "X-Amz-Algorithm", "value": "" }, { "key": "X-Amz-Credential", "value": "" }, { "key": "X-Amz-Security-Token", "value": "" }, { "key": "X-Amz-Signature", "value": "" }, { "key": "X-Amz-SignedHeaders", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"TraceSegmentDocuments\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/TraceSegments", "host": [ "{{baseUrl}}" ], "path": [ "TraceSegments" ] } }, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "uid": "35240-45925d4f-ed31-4f3d-bb05-89afac32d9ce" }, { "id": "d01e9c17-8dbe-4a4e-8753-67dddd3ed371", "name": "ThrottledException", "originalRequest": { "method": "POST", "header": [ { "key": "X-Amz-Content-Sha256", "value": "" }, { "key": "X-Amz-Date", "value": "" }, { "key": "X-Amz-Algorithm", "value": "" }, { "key": "X-Amz-Credential", "value": "" }, { "key": "X-Amz-Security-Token", "value": "" }, { "key": "X-Amz-Signature", "value": "" }, { "key": "X-Amz-SignedHeaders", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"TraceSegmentDocuments\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/TraceSegments", "host": [ "{{baseUrl}}" ], "path": [ "TraceSegments" ] } }, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{}", "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "uid": "35240-d01e9c17-8dbe-4a4e-8753-67dddd3ed371" } ], "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "uid": "35240-079bec6a-e530-46af-9360-76b5e7dcfed8" } ], "id": "33b938bb-a537-40c7-ad0e-b841c30adbd9", "createdAt": "2026-07-28T10:51:29.000Z", "updatedAt": "2026-07-28T10:51:29.000Z", "uid": "35240-33b938bb-a537-40c7-ad0e-b841c30adbd9" } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "variable": [ { "key": "region", "value": "us-east-1" }, { "key": "baseUrl", "value": "http://xray.{{region}}.amazonaws.com" } ] }