# AWS X-Ray API

> AWS X-Ray API on Apizie: 30 endpoints (Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates…, Creates a group resource with a name and a filter expression., Creates a rule to control sampling behavior for instrumented applications. Services retrieve rules with…, Deletes a group resource., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-xray/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-xray`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-xray
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-xray/openapi.json

Amazon Web Services X-Ray provides APIs for managing debug traces and retrieving service maps and other data created by processing those traces.

## Endpoints

### Retrieves a list of traces specified by ID. Each trace is a collection of segment documents that originates…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/batch-get-traces` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Creates a group resource with a name and a filter expression.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/create-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Creates a rule to control sampling behavior for instrumented applications. Services retrieve rules with…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/create-sampling-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Deletes a group resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/delete-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Deletes a resource policy from the target Amazon Web Services account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/delete-resource-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Deletes a sampling rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/delete-sampling-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieves the current encryption configuration for X-Ray data.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-encryption-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Retrieves group resource details.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieves all active group details.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves the summary information of an insight. This includes impact to clients and root cause services,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-insight` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### X-Ray reevaluates insights periodically until they're resolved, and records each intermediate state as an…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-insight-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | string | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves a service graph structure filtered by the specified insight. The service graph is limited to only…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-insight-impact-graph` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieves the summaries of all insights in the specified group matching the provided filter values.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-insight-summaries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | string | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves all sampling rules.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-sampling-rules` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves information about recent sampling results for all sampling rules.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-sampling-statistic-summaries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Requests a sampling quota for rules that the service is using to sample requests.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-sampling-targets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Retrieves a document that describes services that process incoming requests, and downstream services that…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-service-graph` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Get an aggregation of service statistics defined by a specific time range.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-time-series-service-statistics` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves a service graph for one or more specific trace IDs.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-trace-graph` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Retrieves IDs and annotations for traces available for a specified time frame using an optional filter. To…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/get-trace-summaries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns the list of resource policies in the target Amazon Web Services account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/list-resource-policies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Returns a list of tags that are applied to the specified Amazon Web Services X-Ray group or sampling rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | yes | JSON request body |

### Updates the encryption configuration for X-Ray data.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/put-encryption-config` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Sets the resource policy to grant one or more Amazon Web Services services and accounts permissions to…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/put-resource-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Used by the Amazon Web Services X-Ray daemon to upload telemetry.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/put-telemetry-records` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Uploads segment documents to Amazon Web Services X-Ray. The X-Ray SDK generates segment documents and sends…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/put-trace-segments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Applies tags to an existing Amazon Web Services X-Ray group or sampling rule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Removes tags from an Amazon Web Services X-Ray group or sampling rule. You cannot edit or delete system tags…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Updates a group resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/update-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Modifies a sampling rule's configuration.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/update-sampling-rule` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-xray/batch-get-traces" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS X-Ray API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-xray/batch-get-traces with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS X-Ray API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS X-Ray itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS X-Ray API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-xray.

### What is the status of the AWS X-Ray API?
Needs your own provider key (bring your own key)