Amazon Web Services, Inc.

AWS DevOps Agent Service

AWS DevOps Agent is your always-available operations teammate. It resolves and proactively prevents incidents, optimizes application reliability and…

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

AWS DevOps Agent is your always-available operations teammate. It resolves and proactively prevents incidents, optimizes application reliability and performance, and handles on-demand SRE tasks across AWS, multicloud, and on-premises environments. AWS DevOps Agent investigates incidents as an experienced DevOps engineer would. It learns your applications and their relationships. It works with your observability tools, runbooks, code repositories, and CI/CD pipelines. The agent correlates telemetry, code, and deployment data across all of them.

Endpoints 63

Association

  • POSTAssociate service/v1/agentspaces/:agentSpaceId/associationsAdds a specific service association to an AgentSpace. It overwrites the existing association of the same service. Returns 201 Created on success.
  • GETGet association/v1/agentspaces/:agentSpaceId/associations/:associationIdRetrieves given associations configured for a specific AgentSpace.
  • DELETEDisassociate service/v1/agentspaces/:agentSpaceId/associations/:associationIdDeletes a specific service association from an AgentSpace. This operation is idempotent and returns a 204 No Content response on success.
  • PATCHUpdate association/v1/agentspaces/:agentSpaceId/associations/:associationIdPartially updates the configuration of an existing service association for an AgentSpace. Present fields are fully replaced; absent fields are left unchanged.…
  • POSTList associations/v1/agentspaces/:agentSpaceId/associations/list?maxResults=0&nextToken=string&filterServiceTypes=stringList all associations for given AgentSpace
  • POSTList webhooks/v1/agentspaces/:agentSpaceId/associations/:associationId/webhooks/listList all webhooks for given Association
  • POSTValidate aws associations/v1/agentspaces/:agentSpaceId/associations/validateValidates an aws association and set status and returns a 204 No Content response on success.

Agent space

  • POSTCreate agent space/v1/agentspacesCreates a new AgentSpace with the specified name and description. Duplicate space names are allowed.
  • GETGet agent space/v1/agentspaces/:agentSpaceId?includedData=stringRetrieves detailed information about a specific AgentSpace.
  • DELETEDelete agent space/v1/agentspaces/:agentSpaceIdDeletes an AgentSpace. This operation is idempotent and returns a 204 No Content response on success.
  • PATCHUpdate agent space/v1/agentspaces/:agentSpaceIdUpdates the information of an existing AgentSpace.
  • POSTEnable operator app/v1/agentspaces/:agentSpaceId/operatorEnable the Operator App to access the given AgentSpace
  • DELETEDisable operator app/v1/agentspaces/:agentSpaceId/operatorDisable the Operator App for the specified AgentSpace
  • GETGet operator app/v2/agentspaces/:agentSpaceId/operatorGet the full auth configuration of operator including any enabled auth flow
  • POSTList agent spaces/v1/agentspaces/list?maxResults=0&nextToken=string&includedData=stringLists all AgentSpaces with optional pagination.
  • PATCHUpdate operator app idp config/v1/agentspaces/:agentSpaceId/operator/idpUpdate the external Identity Provider configuration for the Operator App

Private connection

  • GETList private connections/v1/private-connectionsLists all Private Connections in the caller's account.
  • POSTCreate private connection/v1/private-connectionsCreates a Private Connection to a target resource.
  • GETDescribe private connection/v1/private-connections/:nameRetrieves details of an existing Private Connection.
  • DELETEDelete private connection/v1/private-connections/:nameDeletes a Private Connection. The deletion is asynchronous and returns DELETE_IN_PROGRESS status.
  • POSTUpdate private connection certificate/v1/private-connections/:name/certificateUpdates the certificate associated with a Private Connection.

Service

  • GETGet service/v1/services/:serviceIdRetrieves given service by it's unique identifier
  • DELETEDeregister service/v1/services/:serviceIdDeregister a service
  • POSTList services/v1/services/list?maxResults=0&nextToken=string&filterServiceType=stringList a list of registered service on the account level.
  • POSTRegister service/v1/register/:serviceThis operation registers the specified service
  • GETList assets/asset/agent-space/:agentSpaceId/assets?assetType=string&updatedAfter=string&updatedBefore=string&nextToken=string&maxResults=0Lists assets in the specified agent space
  • POSTCreate asset/asset/agent-space/:agentSpaceId/assetsCreates a new asset in the specified agent space
  • GETGet asset file/asset/agent-space/:agentSpaceId/assets/:assetId/files/:path?assetVersion=0Gets a file from an asset
  • POSTCreate asset file/asset/agent-space/:agentSpaceId/assets/:assetId/files/:pathCreates a file in an asset
  • DELETEDelete asset file/asset/agent-space/:agentSpaceId/assets/:assetId/files/:pathDeletes a file from an asset
  • PATCHUpdate asset file/asset/agent-space/:agentSpaceId/assets/:assetId/files/:pathUpdates a file in an asset
  • POSTCreate backlog task/backlog/agent-space/:agentSpaceId/tasksCreates a new backlog task in the specified agent space
  • POSTCreate chat/agents/agent-space/:agentSpaceId/chat/create?userId=string&userType=stringCreates a new chat execution in the specified agent space
  • GETList triggers/trigger/agent-space/:agentSpaceId/triggers?status=string&nextToken=string&maxResults=0Lists Triggers in the specified agent space
  • POSTCreate trigger/trigger/agent-space/:agentSpaceId/triggersCreates a new Trigger in the specified agent space
  • GETGet asset/asset/agent-space/:agentSpaceId/assets/:assetId?assetVersion=0Gets an asset from the specified agent space
  • DELETEDelete asset/asset/agent-space/:agentSpaceId/assets/:assetIdDeletes an asset and all its files from the specified agent space
  • PATCHUpdate asset/asset/agent-space/:agentSpaceId/assets/:assetIdUpdates an asset in the specified agent space
  • GETGet trigger/trigger/agent-space/:agentSpaceId/triggers/:triggerIdGets a Trigger from the specified agent space
  • DELETEDelete trigger/trigger/agent-space/:agentSpaceId/triggers/:triggerIdDeletes a Trigger from the specified agent space
  • PATCHUpdate trigger/trigger/agent-space/:agentSpaceId/triggers/:triggerIdUpdates the status of an existing Trigger
  • GETGet account usage/usage/accountRetrieves monthly account usage metrics and limits for the AWS account.
  • GETGet asset content/asset/agent-space/:agentSpaceId/assets/:assetId/content?assetVersion=0Gets an asset's content as a zip bundle
  • GETGet backlog task/backlog/agent-space/:agentSpaceId/tasks/:taskIdGets a backlog task for the specified agent space and task id
  • PATCHUpdate backlog task/backlog/agent-space/:agentSpaceId/tasks/:taskIdUpdate an existing backlog task.
  • GETGet recommendation/backlog/agent-space/:agentSpaceId/recommendations/:recommendationId?recommendationVersion=0Retrieves a specific recommendation by its ID
  • PATCHUpdate recommendation/backlog/agent-space/:agentSpaceId/recommendations/:recommendationIdUpdates an existing recommendation with new content, status, or metadata
  • GETList asset files/asset/agent-space/:agentSpaceId/assets/:assetId/files?assetVersion=0&nextToken=string&maxResults=0Lists files in an asset
  • GETList asset types/asset/types?nextToken=string&maxResults=0Lists the supported asset types
  • GETList asset versions/asset/agent-space/:agentSpaceId/assets/:assetId/versions?maxResults=0&nextToken=stringLists versions of an asset in the specified agent space
  • POSTList backlog tasks/backlog/agent-space/:agentSpaceId/tasks/listLists backlog tasks in the specified agent space with optional filtering and sorting
  • GETList chats/agents/agent-space/:agentSpaceId/chat/list?userId=string&maxResults=0&nextToken=stringRetrieves a paginated list of the user's recent chat executions
  • POSTList executions/journal/agent-space/:agentSpaceId/executionsList executions
  • POSTList goals/backlog/agent-space/:agentSpaceId/goals/listLists goals in the specified agent space with optional filtering
  • POSTList journal records/journal/agent-space/:agentSpaceId/journalRecordsList journal records for a specific execution
  • POSTList pending messages/agents/agent-space/:agentSpaceId/pendingMessagesList pending messages for a specific execution.
  • POSTList recommendations/backlog/agent-space/:agentSpaceId/recommendations/listLists recommendations for the specified agent space
  • GETList tags for resource/tags/:resourceArnLists tags for the specified AWS DevOps Agent resource.
  • POSTTag resource/tags/:resourceArnAdds or overwrites tags for the specified AWS DevOps Agent resource.
  • DELETEUntag resource/tags/:resourceArn?tagKeys=Removes tags from the specified AWS DevOps Agent resource.
  • POSTSend message/agents/agent-space/:agentSpaceId/chat/sendMessageSends a chat message and streams the response for the specified agent space execution
  • POSTUpdate approval action/agents/agent-space/:agentSpaceId/approvals/:approvalId/update-actionUpdates an approval request with the terminal decision (APPROVED or REJECTED). A single operation handles both verbs via the action enum.
  • PATCHUpdate goal/backlog/agent-space/:agentSpaceId/goals/:goalIdUpdate an existing goal

API details

Base URL
https://aidevops.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
63 operations on 42 pathsPOST 25GET 20PATCH 9DELETE 9
Main resources
Agent space 9Association 7Private connection 5Service 4
Description format
AWS Smithy model, API version 2026-01-01

How to test the AWS DevOps Agent Service in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AWS DevOps Agent Service collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Associate service” (POST /v1/agentspaces/:agentSpaceId/associations), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AWS DevOps Agent Service?

AWS DevOps Agent is your always-available operations teammate. It resolves and proactively prevents incidents, optimizes application reliability and… It is listed under Developer tools and has 63 endpoints.

Who publishes the AWS DevOps Agent Service?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the AWS DevOps Agent Service?

Requests go to https://aidevops.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the AWS DevOps Agent Service?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the AWS DevOps Agent Service have?

63 operations on 42 paths (25 POST, 20 GET, 9 PATCH, 9 DELETE). The largest groups are Agent space, Association, Private connection, Service.

Is forking the AWS DevOps Agent Service free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.