--- title: "POST /v1/services/list" method: POST path: "/v1/services/list" --- # POST /v1/services/list `POST /v1/services/list` List a list of registered service on the account level. ## Query parameters - `maxResults` integer - `nextToken` string — Pagination token for list operations (1-2048 characters) - `filterServiceType` 'github' | 'slack' | 'azure' | 'azuredevops' | 'dynatrace' | 'servicenow' | 'pagerduty' | 'gitlab' | 'eventChannel' | 'mcpservernewrelic' | 'mcpservergrafana' | 'mcpserverdatadog' | 'mcpserver' | 'mcpserversplunk' | 'azureidentity' | 'mcpserversigv4' | 'remoteagent' | 'remoteagentsigv4' — Enumeration of all supported service types, combining OAuth 3-legged, client credentials, and simple token authentication methods. ## Response `200` Success - ListServicesOutput — Output containing a list of registered services and pagination token. - `nextToken` string — Token to retrieve the next page of results, if there are more results. - `services` RegisteredService[], required — List of registered services. - `serviceId` string, required — The unique identifier of a service. - `serviceType` 'github' | 'slack' | 'azure' | 'azuredevops' | 'dynatrace' | 'servicenow' | 'pagerduty' | 'gitlab' | 'eventChannel' | 'mcpservernewrelic' | 'mcpservergrafana' | 'mcpserverdatadog' | 'mcpserver' | 'mcpserversplunk' | 'azureidentity' | 'mcpserversigv4' | 'remoteagent' | 'remoteagentsigv4', required — The service type e.g github or dynatrace - `name` string — The display name of the registered service. - `accessibleResources` Document[] — List of accessible resources for this service. - `additionalServiceDetails` object — Additional details specific to the service type. - `github` object — GitHub-specific service details. - `owner` string, required — The GitHub repository owner name. - `ownerType` 'organization' | 'user', required — The GitHub repository owner type. - `targetUrl` string — The GitHub Enterprise Server instance URL (absent for github.com). - `slack` object — Slack-specific service details. - `teamId` string, required — The Slack team ID. - `teamName` string, required — The Slack team name. - `mcpserverdatadog` object — Datadog MCP server-specific service details. - `name` string, required — The MCP server name. - `endpoint` string, required — The MCP server endpoint URL. - `authorizationMethod` 'oauth-client-credentials' | 'oauth-3lo' | 'api-key' | 'bearer-token', required — The MCP server uses this authorization method. - `description` string, password — Optional description for the MCP server. - `apiKeyHeader` string — If the MCP server uses API key authentication, these details are provided. - `mcpserver` object — MCP server-specific service details. - `name` string, required — The MCP server name. - `endpoint` string, required — The MCP server endpoint URL. - `authorizationMethod` 'oauth-client-credentials' | 'oauth-3lo' | 'api-key' | 'bearer-token', required — The MCP server uses this authorization method. - `description` string, password — Optional description for the MCP server. - `apiKeyHeader` string — If the MCP server uses API key authentication, these details are provided. - `servicenow` object — ServiceNow-specific service details. - `instanceUrl` string — The ServiceNow instance url - `gitlab` object — GitLab-specific service details. - `targetUrl` string, required — The GitLab instance URL. - `tokenType` 'personal' | 'group', required — Type of GitLab access token - `groupId` string — Optional GitLab group ID for group-level access tokens - `mcpserversplunk` object — Splunk MCP server-specific service details. - `name` string, required — The MCP server name. - `endpoint` string, required — The MCP server endpoint URL. - `authorizationMethod` 'oauth-client-credentials' | 'oauth-3lo' | 'api-key' | 'bearer-token', required — The MCP server uses this authorization method. - `description` string, password — Optional description for the MCP server. - `apiKeyHeader` string — If the MCP server uses API key authentication, these details are provided. - `mcpservernewrelic` object — New Relic MCP server-specific service details. - `accountId` string, required — The NewRelic account ID. - `region` 'US' | 'EU', required — The NewRelic region (determines API endpoint). - `description` string, password — Optional user description. - `azuredevops` object — Azure DevOps specific service details. - `organizationName` string, required — The Azure DevOps Organization name associated with the service. - `azureidentity` object — Azure identity details for services using Azure authentication. - `tenantId` string, required — The Azure Active Directory tenant ID for the identity. - `clientId` string, required — The client ID of the service principal or managed identity used for authentication. - `webIdentityRoleArn` string, required — The role ARN to be assumed by DevOps Agent for requesting Web Identity Token. - `webIdentityTokenAudiences` String[], required — The audiences for the Web Identity Token. - `mcpservergrafana` object — Grafana MCP server-specific service details. - `endpoint` string, required — Grafana instance URL (e.g., https://your-instance.grafana.net) - `authorizationMethod` 'oauth-client-credentials' | 'oauth-3lo' | 'api-key' | 'bearer-token', required — The authz method used by the MCP server. - `pagerduty` object — Pagerduty service details. - `scopes` String[], required — The scopes that were assigned to the service - `mcpserversigv4` object — SigV4-authenticated MCP server-specific service details. - `name` string, required — MCP server name. - `endpoint` string, required — MCP server endpoint URL. - `description` string, password — Optional description for the MCP server. - `region` string, required — AWS region for SigV4 signing. Use '*' for SigV4a multi-region signing. - `service` string, required — AWS service name for SigV4 signing. - `roleArn` string, required — IAM role ARN to assume for SigV4 signing.Use mcpRoleArn instead. - `mcpRoleArn` string — AWS IAM role ARN. - `customHeaders` object — Custom headers for the SigV4 MCP server. - `remoteagent` object — Remote A2A agent-specific service details (token-based auth). - `name` string, required — Name identifier for a remote A2A agent. - `endpoint` string, required — HTTPS endpoint URL for a remote A2A agent. - `description` string, password — Description field - `authorizationMethod` 'oauth-client-credentials' | 'api-key' | 'bearer-token', required — The authorization method used by the remote agent. - `apiKeyHeader` string — If the remote agent uses API key authentication, the header name. - `remoteagentsigv4` object — Remote A2A agent-specific service details (SigV4 auth). - `name` string, required — Name identifier for a remote A2A agent. - `endpoint` string, required — HTTPS endpoint URL for a remote A2A agent. - `description` string, password — Description field - `region` string, required — AWS region identifier or wildcard (*) for SigV4a multi-region signing. - `service` string, required — The AWS service name for SigV4 signing. - `roleArn` string — AWS IAM role ARN. - `kmsKeyArn` string — The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources. - `privateConnectionName` string — The name of the private connection used for VPC connectivity. ## Other responses - `480` — ValidationException - `481` — ContentSizeExceededException - `482` — ServiceQuotaExceededException - `483` — ConflictException - `484` — InternalServerException - `485` — AccessDeniedException - `486` — ThrottlingException - `487` — InvalidParameterException - `488` — ResourceNotFoundException --- [API](https://skmtc.net/aws/apis/devops-agent.md) · [All operations](https://skmtc.net/aws/apis/devops-agent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devops-agent/versions/ca2af02d3853/schema)