Skip to content

feat(usage): deprecate legacy periodic-usage endpoints [MOI-7252] #224

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Chase Poirier (chasepoirier) merged 1 commit into from
Aug 18, 2026
Merged

feat(usage): deprecate legacy periodic-usage endpoints [MOI-7252] #224

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions src/main/java/com/contentful/java/cma/ModuleOrganizationUsage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,11 @@ protected ServiceOrganizationUsage createService(Retrofit retrofit) {
*
* @param query the criteria to narrow down the search result.
* @return {@link CMAUsage} result instance
* @deprecated The {@code GET /organizations/{organization_id}/organization_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
public CMAArray<CMAUsage> fetchAll(
String organizationId,
Map<String, String> query) {
Expand Down Expand Up @@ -66,7 +70,11 @@ public class Async {


* @return {@link CMAUsage} result callback.
* @deprecated The {@code GET /organizations/{organization_id}/organization_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
public CMACallback<CMAArray<CMAUsage>> fetchAll(
String organizationId,
Map<String, String> query,
Expand Down
8 changes: 8 additions & 0 deletions src/main/java/com/contentful/java/cma/ModuleSpaceUsage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,11 @@ protected ServiceSpaceUsage createService(Retrofit retrofit) {
* @param organizationId organization id for the request.
* @param query the criteria to narrow down the search result.
* @return {@link CMAUsage} result instance
* @deprecated The {@code GET /organizations/{organization_id}/space_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
public CMAArray<CMAUsage> fetchAll(
String organizationId,
Map<String, String> query) {
Expand Down Expand Up @@ -66,7 +70,11 @@ public class Async {
* @param organizationId organization id for the request.
* @param query possible parameters of the request.
* @return {@link CMAUsage} result callback.
* @deprecated The {@code GET /organizations/{organization_id}/space_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
public CMACallback<CMAArray<CMAUsage>> fetchAll(
String organizationId,
Map<String, String> query,
Expand Down
12 changes: 12 additions & 0 deletions src/main/java/com/contentful/java/cma/ServiceOrganizationUsage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,23 @@

public interface ServiceOrganizationUsage {

/**
* @deprecated The {@code GET /organizations/{organization_id}/organization_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
@GET("organizations/{organization_id}/organization_periodic_usages")
Flowable<CMAArray<CMAUsage>> fetchAll(
@Path("organization_id") String organizationId
);

/**
* @deprecated The {@code GET /organizations/{organization_id}/organization_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
@GET("organizations/{organization_id}/organization_periodic_usages")
Flowable<CMAArray<CMAUsage>> fetchAll(
@Path("organization_id") String organizationId,
Expand Down
12 changes: 12 additions & 0 deletions src/main/java/com/contentful/java/cma/ServiceSpaceUsage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,23 @@
import java.util.Map;

public interface ServiceSpaceUsage {
/**
* @deprecated The {@code GET /organizations/{organization_id}/space_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
@GET("organizations/{organization_id}/space_periodic_usages")
Flowable<CMAArray<CMAUsage>> fetchAll(
@Path("organization_id") String organizationId
);

/**
* @deprecated The {@code GET /organizations/{organization_id}/space_periodic_usages}
* endpoint is deprecated in favor of the new Usage API. It will be removed on
* 2027-02-28, after which requests will return 410 Gone.
*/
@Deprecated
@GET("organizations/{organization_id}/space_periodic_usages")
Flowable<CMAArray<CMAUsage>> fetchAll(
@Path("organization_id") String organizationId,
Expand Down
7 changes: 7 additions & 0 deletions src/main/java/com/contentful/java/cma/model/CMAUsage.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@

import java.util.LinkedHashMap;

/**
* @deprecated The {@code GET /organizations/{organization_id}/organization_periodic_usages}
* and {@code GET /organizations/{organization_id}/space_periodic_usages} endpoints are
* deprecated in favor of the new Usage API. They will be removed on 2027-02-28, after
* which requests will return 410 Gone.
*/
@Deprecated
public class CMAUsage extends CMAResource {
private String unitOfMeasure;
private UsageMetric metric;
Expand Down
Loading