# Amazon CodeGuru Profiler API

> Amazon CodeGuru Profiler API on Apizie: 23 endpoints (Get the current configuration for anomaly notifications for a profiling group., Add up to 2 anomaly notifications channels for a profiling group., Returns the time series of values for a requested list of frame metrics from a time period., Used by profiler agents to report their current state and to receive remote configuration updates. For…, …) 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://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-codeguruprofiler`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-codeguruprofiler
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-codeguruprofiler/openapi.json

This section provides documentation for the Amazon CodeGuru Profiler API operations. Amazon CodeGuru Profiler collects runtime performance data from your live applications, and provides recommendations that can help…

## Endpoints

### Get the current configuration for anomaly notifications for a profiling group.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-notification-configuration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group we want to get the notification configuration for. |

### Add up to 2 anomaly notifications channels for a profiling group.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/add-notification-channels` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group that we are setting up notifications for. |
| body | object | yes | JSON request body |

### Returns the time series of values for a requested list of frame metrics from a time period.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/batch-get-frame-metric-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| endTime | string | no | The end time of the time period for the returned time series values. This is specified using the ISO 8601 format. For example,… |
| period | string | no | The duration of the frame metrics used to return the time series values. Specify using the ISO 8601 format. The maximum period duration is… |
| profilingGroupName | string | yes | The name of the profiling group associated with the the frame metrics used to return the time series values. |
| startTime | string | no | The start time of the time period for the frame metrics used to return the time series values. This is specified using the ISO 8601… |
| targetResolution | string | no | The requested resolution of time steps for the returned time series of values. If the requested target resolution is not available due to… |
| body | object | yes | JSON request body |

### Used by profiler agents to report their current state and to receive remote configuration updates. For…
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/configure-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group for which the configured agent is collecting profiling data. |
| body | object | yes | JSON request body |

### Creates a profiling group.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/create-profiling-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| clientToken | string | yes | Amazon CodeGuru Profiler uses this universally unique identifier (UUID) to prevent the accidental creation of duplicate profiling groups… |
| body | object | yes | JSON request body |

### Returns a ProfilingGroupDescription object that contains information about the requested profiling group.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/describe-profiling-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group to get information about. |

### Updates a profiling group.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/update-profiling-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group to update. |
| body | object | yes | JSON request body |

### Deletes a profiling group.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/delete-profiling-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group to delete. |

### Returns a list of FindingsReportSummary objects that contain analysis results for all profiling groups in…
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-findings-report-account-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| dailyReportsOnly | boolean | no | A Boolean value indicating whether to only return reports from daily profiles. If set to True , only analysis data from daily profiles is… |
| maxResults | integer | no | The maximum number of results returned by GetFindingsReportAccountSummary in paginated output. When this parameter is used,… |
| nextToken | string | no | The nextToken value returned from a previous paginated GetFindingsReportAccountSummary request where maxResults was used and the results… |

### Returns the JSON-formatted resource-based policy on a profiling group.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profilingGroupName | string | yes | The name of the profiling group. |

### Gets the aggregated profile of a profiling group for a specified time range. Amazon CodeGuru Profiler…
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| endTime | string | no | The end time of the requested profile. Specify using the ISO 8601 format. For example, 2020-06-01T13:15:02.001Z represents 1 millisecond… |
| maxDepth | integer | no | The maximum depth of the stacks in the code that is represented in the aggregated profile. For example, if CodeGuru Profiler finds a… |
| period | string | no | Used with startTime or endTime to specify the time range for the returned aggregated profile. Specify using the ISO 8601 format. For… |
| profilingGroupName | string | yes | The name of the profiling group to get. |
| startTime | string | no | The start time of the profile to get. Specify using the ISO 8601 format. For example, 2020-06-01T13:15:02.001Z represents 1 millisecond… |

### Returns a list of Recommendation objects that contain recommendations for a profiling group for a given time…
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-recommendations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| endTime | string | yes | The start time of the profile to get analysis data about. You must specify startTime and endTime . This is specified using the ISO 8601… |
| locale | string | no | The language used to provide analysis. Specify using a string that is one of the following BCP 47 language codes. de-DE - German, Germany… |
| profilingGroupName | string | yes | The name of the profiling group to get analysis data about. |
| startTime | string | yes | The end time of the profile to get analysis data about. You must specify startTime and endTime . This is specified using the ISO 8601… |

### List the available reports for a given profiling group and time range.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/list-findings-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| dailyReportsOnly | boolean | no | A Boolean value indicating whether to only return reports from daily profiles. If set to True , only analysis data from daily profiles is… |
| endTime | string | yes | The end time of the profile to get analysis data about. You must specify startTime and endTime . This is specified using the ISO 8601… |
| maxResults | integer | no | The maximum number of report results returned by ListFindingsReports in paginated output. When this parameter is used, ListFindingsReports… |
| nextToken | string | no | The nextToken value returned from a previous paginated ListFindingsReportsRequest request where maxResults was used and the results… |
| profilingGroupName | string | yes | The name of the profiling group from which to search for analysis data. |
| startTime | string | yes | The start time of the profile to get analysis data about. You must specify startTime and endTime . This is specified using the ISO 8601… |

### Lists the start times of the available aggregated profiles of a profiling group for an aggregation period…
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/list-profile-times` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| endTime | string | yes | The end time of the time range from which to list the profiles. |
| maxResults | integer | no | The maximum number of profile time results returned by ListProfileTimes in paginated output. When this parameter is used, ListProfileTimes… |
| nextToken | string | no | The nextToken value returned from a previous paginated ListProfileTimes request where maxResults was used and the results exceeded the… |
| orderBy | string | no | The order (ascending or descending by start time of the profile) to use when listing profiles. Defaults to TIMESTAMP_DESCENDING . |
| period | string | yes | The aggregation period. This specifies the period during which an aggregation profile collects posted agent profiles for a profiling… |
| profilingGroupName | string | yes | The name of the profiling group. |
| startTime | string | yes | The start time of the time range from which to list the profiles. |

### Returns a list of profiling groups. The profiling groups are returned as ProfilingGroupDescription objects.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/list-profiling-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| includeDescription | boolean | no | A Boolean value indicating whether to include a description. If true , then a list of ProfilingGroupDescription objects that contain… |
| maxResults | integer | no | The maximum number of profiling groups results returned by ListProfilingGroups in paginated output. When this parameter is used,… |
| nextToken | string | no | The nextToken value returned from a previous paginated ListProfilingGroups request where maxResults was used and the results exceeded the… |

### Returns a list of the tags that are assigned to a specified resource.
`GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that contains the tags to return. |

### Use to assign one or more tags to a resource.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that the tags are added to. |
| body | object | yes | JSON request body |

### Submits profiling data to an aggregated profile of a profiling group. To get an aggregated profile that is…
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/post-agent-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| profileToken | string | no | Amazon CodeGuru Profiler uses this universally unique identifier (UUID) to prevent the accidental submission of duplicate profiling data… |
| profilingGroupName | string | yes | The name of the profiling group with the aggregated profile that receives the submitted profiling data. |
| body | object | yes | JSON request body |

### Adds permissions to a profiling group's resource-based policy that are provided using an action group. If a…
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/put-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| actionGroup | string | yes | Specifies an action group that contains permissions to add to a profiling group resource. One action group is supported, agentPermissions… |
| profilingGroupName | string | yes | The name of the profiling group to grant access to. |
| body | object | yes | JSON request body |

### Remove one anomaly notifications channel for a profiling group.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/remove-notification-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| channelId | string | yes | The id of the channel that we want to stop receiving notifications. |
| profilingGroupName | string | yes | The name of the profiling group we want to change notification configuration for. |

### Removes permissions from a profiling group's resource-based policy that are provided using an action group.…
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/remove-permission` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| actionGroup | string | yes | Specifies an action group that contains the permissions to remove from a profiling group's resource-based policy. One action group is… |
| profilingGroupName | string | yes | The name of the profiling group. |
| revisionId | string | yes | A universally unique identifier (UUID) for the revision of the resource-based policy from which you want to remove permissions. |

### Sends feedback to CodeGuru Profiler about whether the anomaly detected by the analysis is useful or not.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/submit-feedback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| anomalyInstanceId | string | yes | The universally unique identifier (UUID) of the AnomalyInstance object that is included in the analysis data. |
| profilingGroupName | string | yes | The name of the profiling group that is associated with the analysis data. |
| body | object | yes | JSON request body |

### Use to remove one or more tags from a resource.
`POST https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The Amazon Resource Name (ARN) of the resource that contains the tags to remove. |
| tagKeys | array | yes | A list of tag keys. Existing tags of resources with keys in this list are removed from the specified resource. |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-notification-configuration" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon CodeGuru Profiler API?
Create a free Apizie key, then send GET https://apizie.tech/v1/cloud:amazonaws-codeguruprofiler/get-notification-configuration with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Amazon CodeGuru Profiler API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-codeguruprofiler.

### What is the status of the Amazon CodeGuru Profiler API?
Needs your own provider key (bring your own key)