feat: create/delete/enable/disable API keys (#372)

# Description

<!-- Please provide a general summary of your PR changes and link any
related issues or other pull requests. -->

# Testing

<!--
Please provide details on how you tested this code. See below.

- All pull requests must be tested (unit tests where possible with
accompanying cassettes, or provide a screenshot of end-to-end testing
when unit tests are not possible)
- New features must get a new unit test
- Bug fixes/refactors must re-record existing cassettes 
-->

# Pull Request Type

Please select the option(s) that are relevant to this PR.

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] Improvement (fixing a typo, updating readme, renaming a variable
name, etc)

Author: Justintime50

CHANGELOG.md

@@ -1,5 +1,13 @@
 # CHANGELOG
 
+## v8.6.0 (2026-02-03)
+
+- Adds the following functions usable by child and referral customer users:
+  - `apiKey.create`
+  - `apiKey.delete`
+  - `apiKey.enable`
+  - `apiKey.disable`
+
 ## v8.5.1 (2026-01-08)
 
 - Corrects `StatelessRateDeserializer` and `WebhookDeserializer` to treat all camelCase fields like all other models to properly deserialize JSON fields containing underscors

README.md

@@ -16,7 +16,7 @@ Add this to your project's POM:
 <dependency>
   <groupId>com.easypost</groupId>
   <artifactId>easypost-api-client</artifactId>
-  <version>8.5.1</version>
+  <version>8.6.0</version>
 </dependency>
 ```
 
@@ -25,7 +25,7 @@ Add this to your project's POM:
 Add this to your project's build file:
 
 ```groovy
-implementation "com.easypost:easypost-api-client:8.5.1"
+implementation "com.easypost:easypost-api-client:8.6.0"
 ```
 
 **NOTE:** [Google Gson](http://code.google.com/p/google-gson/) is required.

VERSION

@@ -1 +1 @@
-8.5.1
+8.6.0

pom.xml

@@ -6,7 +6,7 @@
     <groupId>com.easypost</groupId>
     <artifactId>easypost-api-client</artifactId>
 
-    <version>8.5.1</version>
+    <version>8.6.0</version>
     <packaging>jar</packaging>
 
     <name>com.easypost:easypost-api-client</name>

src/main/java/com/easypost/model/ApiKey.java

@@ -5,4 +5,5 @@
 @Getter
 public final class ApiKey extends EasyPostResource {
     private String key;
+    private Boolean active;
 }

src/main/java/com/easypost/service/ApiKeyService.java

@@ -23,18 +23,6 @@ public class ApiKeyService {
         this.client = client;
     }
 
-    /**
-     * Get all API keys.
-     *
-     * @return ApiKeys object.
-     * @throws EasyPostException when the request fails.
-     */
-    public ApiKeys all() throws EasyPostException {
-        String endpoint = "api_keys";
-
-        return Requestor.request(RequestMethod.GET, endpoint, null, ApiKeys.class, client);
-    }
-
     /**
      * Get this User's API keys.
      *
@@ -57,4 +45,70 @@ public List<ApiKey> retrieveApiKeysForUser(final String id) throws EasyPostExcep
 
         throw new FilteringError(String.format(Constants.ErrorMessages.NO_OBJECT_FOUND, "API keys"));
     }
+
+    /**
+     * Get all API keys.
+     *
+     * @return ApiKeys object.
+     * @throws EasyPostException when the request fails.
+     */
+    public ApiKeys all() throws EasyPostException {
+        String endpoint = "api_keys";
+
+        return Requestor.request(RequestMethod.GET, endpoint, null, ApiKeys.class, client);
+    }
+
+    /**
+     * Create an API key for a child or referral customer user.
+     *
+     * @param mode The mode of the API key (production or test).
+     * @return ApiKey object.
+     * @throws EasyPostException when the request fails.
+     */
+    public ApiKey create(final String mode) throws EasyPostException {
+        String endpoint = "api_keys";
+
+        java.util.Map<String, Object> params = new java.util.HashMap<>();
+        params.put("mode", mode);
+
+        return Requestor.request(RequestMethod.POST, endpoint, params, ApiKey.class, client);
+    }
+
+    /**
+     * Delete an API key for a child or referral customer user.
+     *
+     * @param id The ID of the API key to delete.
+     * @throws EasyPostException when the request fails.
+     */
+    public void delete(final String id) throws EasyPostException {
+        String endpoint = String.format("api_keys/%s", id);
+
+        Requestor.request(RequestMethod.DELETE, endpoint, null, ApiKey.class, client);
+    }
+
+    /**
+     * Enable a child or referral customer API key.
+     *
+     * @param id The ID of the API key to enable.
+     * @return ApiKey object.
+     * @throws EasyPostException when the request fails.
+     */
+    public ApiKey enable(final String id) throws EasyPostException {
+        String endpoint = String.format("api_keys/%s/enable", id);
+
+        return Requestor.request(RequestMethod.POST, endpoint, null, ApiKey.class, client);
+    }
+
+    /**
+     * Disable a child or referral customer API key.
+     *
+     * @param id The ID of the API key to disable.
+     * @return ApiKey object.
+     * @throws EasyPostException when the request fails.
+     */
+    public ApiKey disable(final String id) throws EasyPostException {
+        String endpoint = String.format("api_keys/%s/disable", id);
+
+        return Requestor.request(RequestMethod.POST, endpoint, null, ApiKey.class, client);
+    }
 }