How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Gradle TestDistribution API

Endpoints related to the management of Test Distribution resources.To access these endpoints the user requires the `Admin` permission.

Gradle TestDistribution API is one of 9 APIs that Gradle publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include TestDistribution. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 11 operations across 5 paths, and defines 10 schemas. It is described by OpenAPI 3.2.0, at version 2026.2.0.

Requests are made against a single base URL, https://develocity.example.com.

11 operations 5 paths 10 schemas 2 DELETE5 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026.2.0
Base URL
https://develocity.example.com/api
Authentication
HTTP Bearer
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Gradle TestDistribution API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (Bearer <>) (DevelocityAccessKeyOrToken). By default, every request must be authenticated.

  • DevelocityAccessKeyOrToken — All requests require a Develocity access key or token as a bearer token. Given an access key of l3an7wk3j4ze5v4mi7rvgjf2p7g44nvlswg4cpvdonjs7rzd4kmq, the requi…

Paths & Operations 11

Across 5 paths, the API surfaces 11 operations — 2 DELETE, 5 GET, 2 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

TestDistribution 11

Endpoints related to the management of Test Distribution resources. To access these endpoints the user requires the Admin permission.

GET
/api/test-distribution/agent-pools
Lists Agent Pools.
ListTestDistributionAgentPools → 200403404
POST
/api/test-distribution/agent-pools
Create an Agent Pool.
CreateTestDistributionAgentPool body → 200400403404
GET
/api/test-distribution/agent-pools/{poolId}
View the properties of an Agent Pool
GetTestDistributionAgentPool 1 param → 200403404
PUT
/api/test-distribution/agent-pools/{poolId}
Create or update an Agent Pool.
CreateOrUpdateTestDistributionAgentPool 1 param body → 200400403404
DELETE
/api/test-distribution/agent-pools/{poolId}
Delete an Agent Pool.
DeleteTestDistributionAgentPool 1 param → 200403404
GET
/api/test-distribution/agent-pools/{poolId}/registration-keys
Lists Test Distribution pool-specific agent registration keys.
ListTestDistributionAgentPoolRegistrationKeys 1 param → 200403404
POST
/api/test-distribution/agent-pools/{poolId}/registration-keys
Generate a new Test Distribution pool-specific agent registration key.
GenerateTestDistributionAgentPoolRegistrationKey 1 param body → 200403404
GET
/api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}
Get a Test Distribution pool-specific agent registration keyPrefix information.
GetTestDistributionAgentPoolRegistrationKey 2 params → 200403404
PUT
/api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}
Insert a specific Test Distribution pool-specific agent registration key.
InsertTestDistributionAgentPoolRegistrationKey 2 params body → 200400403404
DELETE
/api/test-distribution/agent-pools/{poolId}/registration-keys/{keyPrefix}
Revoke a Test Distribution pool-specific agent registration key.
RevokeTestDistributionAgentPoolRegistrationKey 2 params → 200403404
GET
/api/test-distribution/agent-pools/{poolId}/status
View the status of an Agent Pool
GetTestDistributionAgentPoolStatus 1 param → 200403404

Schemas 10

The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are TestDistributionAgentPoolConfigurationWithId (8 properties), TestDistributionAgentPoolStatus (7 properties), TestDistributionAgentPoolConfiguration (7 properties), TestDistributionAgentPoolRegistrationKeyPrefix (6 properties). Each schema is shown below with its type and property counts.

TestDistributionAgentPoolStatus
object
The status of an agent pool.
7 properties 7 required
TestDistributionAgentPoolRegistrationKeyDescription
object
Optional description of a Test Distribution pool-specific agent registration key.
1 property
ApiProblem
object
Response detailing why a request was rejected. Adheres to the [RFC-7807](https://datatracker.ietf.org/doc/html/rfc7807) standard (colloquially known as "Proble…
4 properties 3 required
TestDistributionAgentPoolRegistrationKeyPrefixPage
object
A list of Test Distribution pool-specific agent registration key prefixes.
1 property 1 required
TestDistributionAgentPoolId
string
The unique identifier of the agent pool.
TestDistributionAgentPoolConfiguration
object
An agent pool configuration.
7 properties 4 required
TestDistributionAgentPoolConfigurationWithId
object
An agent pool configuration.
8 properties 6 required
TestDistributionAgentPoolRegistrationKey
object
A Test Distribution pool-specific agent registration key.
2 properties 1 required
TestDistributionAgentPoolPage
object
A list of agent pools.
1 property 1 required
TestDistributionAgentPoolRegistrationKeyPrefix
object
A Test Distribution pool-specific agent registration key prefix.
6 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

gradle-testdistribution-api-openapi.yml Raw ↑

Other APIs Gradle publishes across the network.

Gradle Auth API
Gradle BuildCache API
Gradle Builds API
Gradle Comparison API
Gradle Failures API
Gradle Meta API
Gradle Projects API
Gradle Tests API
Where this information came from

This is an independent, third-party profile of Gradle TestDistribution API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.