hook0-client 2.0.0

data/lib/hook0/generated/api.rb

@@ -0,0 +1,1097 @@
+# Generated by hook0-sdkgen from the OpenAPI snapshot the API crate commits.
+# Do not edit by hand: run `UPDATE_SDK=ruby cargo test -p hook0-sdkgen sdk_targets` and commit the result.
+# frozen_string_literal: true
+
+require_relative "../runtime"
+require_relative "errors"
+require_relative "models"
+
+module Hook0
+  # One class per entity the API declares, one method per operation it groups under it.
+  module Generated
+    # What the API declares under `applicationSecrets`, issued through the transport it is handed.
+    class ApplicationSecretsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Create a new application secret
+      #
+      # @param body [ApplicationSecretPost] what the operation reads
+      # @return [ApplicationSecret]
+      def create(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/application_secrets/",
+            [],
+            body.to_h
+          ),
+          ApplicationSecret.method(:from_json)
+        )
+      end
+
+      # Delete an application secret
+      #
+      # @param application_secret_token [String] carries `application_secret_token`.
+      # @param application_id [String] carries `application_id`.
+      # @return [void]
+      def delete(application_secret_token, application_id)
+        check_answer(
+          @transport.request(
+            "DELETE",
+            Runtime.path(
+              "/api/v1/application_secrets/{application_secret_token}",
+              "application_secret_token" => application_secret_token
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          )
+        )
+      end
+
+      # List application secrets
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [Array<ApplicationSecret>]
+      def read(application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/application_secrets/",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(ApplicationSecret.method(:from_json))
+        )
+      end
+
+      # Update an application secret
+      #
+      # @param application_secret_token [String] carries `application_secret_token`.
+      # @param body [ApplicationSecretPost] what the operation reads
+      # @return [ApplicationSecret]
+      def update(application_secret_token, body)
+        read_answer(
+          @transport.request(
+            "PUT",
+            Runtime.path(
+              "/api/v1/application_secrets/{application_secret_token}",
+              "application_secret_token" => application_secret_token
+            ),
+            [],
+            body.to_h
+          ),
+          ApplicationSecret.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `applications`, issued through the transport it is handed.
+    class ApplicationsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Create a new application
+      #
+      # @param body [ApplicationPost] what the operation reads
+      # @return [Application]
+      def create(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/applications/",
+            [],
+            body.to_h
+          ),
+          Application.method(:from_json)
+        )
+      end
+
+      # Delete an application
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [void]
+      def delete(application_id)
+        check_answer(
+          @transport.request(
+            "DELETE",
+            Runtime.path(
+              "/api/v1/applications/{application_id}",
+              "application_id" => application_id
+            ),
+            [],
+            nil
+          )
+        )
+      end
+
+      # Get an application by its ID
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [ApplicationInfo]
+      def get(application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/applications/{application_id}",
+              "application_id" => application_id
+            ),
+            [],
+            nil
+          ),
+          ApplicationInfo.method(:from_json)
+        )
+      end
+
+      # List applications
+      #
+      # @param organization_id [String] carries `organization_id`.
+      # @return [Array<Application>]
+      def list(organization_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/applications/",
+            Runtime.query(
+              [
+                ["organization_id", organization_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(Application.method(:from_json))
+        )
+      end
+
+      # Edit an application
+      #
+      # @param application_id [String] carries `application_id`.
+      # @param body [ApplicationPost] what the operation reads
+      # @return [Application]
+      def update(application_id, body)
+        read_answer(
+          @transport.request(
+            "PUT",
+            Runtime.path(
+              "/api/v1/applications/{application_id}",
+              "application_id" => application_id
+            ),
+            [],
+            body.to_h
+          ),
+          Application.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `errors`, issued through the transport it is handed.
+    class ErrorsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # List errors
+      #
+      # @return [Array<Problem>]
+      def list
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/errors/",
+            [],
+            nil
+          ),
+          Runtime.list(Problem.method(:from_json))
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `eventTypes`, issued through the transport it is handed.
+    class EventTypesApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Create a new event type
+      #
+      # @param body [EventTypePost] what the operation reads
+      # @return [EventType]
+      def create(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/event_types/",
+            [],
+            body.to_h
+          ),
+          EventType.method(:from_json)
+        )
+      end
+
+      # Delete an event type
+      #
+      # @param event_type_name [String] carries `event_type_name`.
+      # @param application_id [String] carries `application_id`.
+      # @return [void]
+      def delete(event_type_name, application_id)
+        check_answer(
+          @transport.request(
+            "DELETE",
+            Runtime.path(
+              "/api/v1/event_types/{event_type_name}",
+              "event_type_name" => event_type_name
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          )
+        )
+      end
+
+      # Get an event type by its name
+      #
+      # @param event_type_name [String] carries `event_type_name`.
+      # @param application_id [String] carries `application_id`.
+      # @return [EventType]
+      def get(event_type_name, application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/event_types/{event_type_name}",
+              "event_type_name" => event_type_name
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          EventType.method(:from_json)
+        )
+      end
+
+      # List event types
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [Array<EventType>]
+      def list(application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/event_types/",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(EventType.method(:from_json))
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `events`, issued through the transport it is handed.
+    class EventsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Get an event by its ID
+      #
+      # @param event_id [String] carries `event_id`.
+      # @param application_id [String] carries `application_id`.
+      # @return [EventWithPayload]
+      def get(event_id, application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/events/{event_id}",
+              "event_id" => event_id
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          EventWithPayload.method(:from_json)
+        )
+      end
+
+      # Ingest an event
+      #
+      # @param body [EventPost] what the operation reads
+      # @return [IngestedEvent]
+      def ingest(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/event/",
+            [],
+            body.to_h
+          ),
+          IngestedEvent.method(:from_json)
+        )
+      end
+
+      # List latest events
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [Array<Event>]
+      def list(application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/events/",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(Event.method(:from_json))
+        )
+      end
+
+      # Replay an event
+      #
+      # @param event_id [String] carries `event_id`.
+      # @param body [ReplayEvent] what the operation reads
+      # @return [void]
+      def replay(event_id, body)
+        check_answer(
+          @transport.request(
+            "POST",
+            Runtime.path(
+              "/api/v1/events/{event_id}/replay",
+              "event_id" => event_id
+            ),
+            [],
+            body.to_h
+          )
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `events_per_day`, issued through the transport it is handed.
+    class EventsPerDayApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # List events per day for an application
+      #
+      # @param application_id [String] carries `application_id`.
+      # @param from [String, nil] carries `from`: Start of date range (inclusive). Defaults to 30 days before `to`.
+      # @param to [String, nil] carries `to`: End of date range (inclusive). Defaults to today.
+      # @return [Array<EventsPerDayEntry>]
+      def list_for_application(application_id, from: nil, to: nil)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/events_per_day/application",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              [
+                ["from", from],
+                ["to", to]
+              ]
+            ),
+            nil
+          ),
+          Runtime.list(EventsPerDayEntry.method(:from_json))
+        )
+      end
+
+      # List events per day for an organization
+      #
+      # @param organization_id [String] carries `organization_id`.
+      # @param from [String, nil] carries `from`: Start of date range (inclusive). Defaults to 30 days before `to`.
+      # @param to [String, nil] carries `to`: End of date range (inclusive). Defaults to today.
+      # @return [Array<EventsPerDayEntry>]
+      def list_for_organization(organization_id, from: nil, to: nil)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/events_per_day/organization",
+            Runtime.query(
+              [
+                ["organization_id", organization_id]
+              ],
+              [
+                ["from", from],
+                ["to", to]
+              ]
+            ),
+            nil
+          ),
+          Runtime.list(EventsPerDayEntry.method(:from_json))
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `instance`, issued through the transport it is handed.
+    class InstanceApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Get instance configuration
+      #
+      # @return [InstanceConfig]
+      def get
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/instance/",
+            [],
+            nil
+          ),
+          InstanceConfig.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `payload_content_types`, issued through the transport it is handed.
+    class PayloadContentTypesApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # List supported event payload content types
+      #
+      # @return [Array<String>]
+      def list
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/payload_content_types/",
+            [],
+            nil
+          ),
+          Runtime.list(Runtime::TEXT)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `quotas`, issued through the transport it is handed.
+    class QuotasApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Get quotas
+      #
+      # @return [QuotasResponse]
+      def get
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/quotas/",
+            [],
+            nil
+          ),
+          QuotasResponse.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `requestAttempts`, issued through the transport it is handed.
+    class RequestAttemptsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Get a request attempt by its ID
+      #
+      # @param request_attempt_id [String] carries `request_attempt_id`.
+      # @param application_id [String] carries `application_id`.
+      # @return [RequestAttempt]
+      def get(request_attempt_id, application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/request_attempts/{request_attempt_id}",
+              "request_attempt_id" => request_attempt_id
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          RequestAttempt.method(:from_json)
+        )
+      end
+
+      # List request attempts
+      #
+      # @param application_id [String] carries `application_id`.
+      # @param event_event_type_names [String, nil] carries `event.event_type_names`: Comma-separated event types
+      # @param event_id [String, nil] carries `event_id`.
+      # @param max_created_at [String, nil] carries `max_created_at`.
+      # @param min_created_at [String, nil] carries `min_created_at`.
+      # @param pagination_cursor [String, nil] carries `pagination_cursor`.
+      # @param subscription_id [String, nil] carries `subscription_id`.
+      # @return [Array<RequestAttempt>]
+      def read(
+        application_id,
+        event_event_type_names: nil,
+        event_id: nil,
+        max_created_at: nil,
+        min_created_at: nil,
+        pagination_cursor: nil,
+        subscription_id: nil
+      )
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/request_attempts/",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              [
+                ["event.event_type_names", event_event_type_names],
+                ["event_id", event_id],
+                ["max_created_at", max_created_at],
+                ["min_created_at", min_created_at],
+                ["pagination_cursor", pagination_cursor],
+                ["subscription_id", subscription_id]
+              ]
+            ),
+            nil
+          ),
+          Runtime.list(RequestAttempt.method(:from_json))
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `response`, issued through the transport it is handed.
+    class ResponseApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Get a response by its ID
+      #
+      # @param response_id [String] carries `response_id`.
+      # @param application_id [String] carries `application_id`.
+      # @return [Response]
+      def get(response_id, application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/responses/{response_id}",
+              "response_id" => response_id
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Response.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `serviceToken`, issued through the transport it is handed.
+    class ServiceTokenApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Create a new service token
+      #
+      # @param body [ServiceTokenPost] what the operation reads
+      # @return [ServiceToken]
+      def create(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/service_token/",
+            [],
+            body.to_h
+          ),
+          ServiceToken.method(:from_json)
+        )
+      end
+
+      # Delete a service token
+      #
+      # @param service_token_id [String] carries `service_token_id`.
+      # @param organization_id [String] carries `organization_id`.
+      # @return [void]
+      def delete(service_token_id, organization_id)
+        check_answer(
+          @transport.request(
+            "DELETE",
+            Runtime.path(
+              "/api/v1/service_token/{service_token_id}",
+              "service_token_id" => service_token_id
+            ),
+            Runtime.query(
+              [
+                ["organization_id", organization_id]
+              ],
+              []
+            ),
+            nil
+          )
+        )
+      end
+
+      # Edit a service token
+      #
+      # @param service_token_id [String] carries `service_token_id`.
+      # @param body [ServiceTokenPost] what the operation reads
+      # @return [ServiceToken]
+      def edit(service_token_id, body)
+        read_answer(
+          @transport.request(
+            "PUT",
+            Runtime.path(
+              "/api/v1/service_token/{service_token_id}",
+              "service_token_id" => service_token_id
+            ),
+            [],
+            body.to_h
+          ),
+          ServiceToken.method(:from_json)
+        )
+      end
+
+      # Get a service token
+      #
+      # @param service_token_id [String] carries `service_token_id`.
+      # @param organization_id [String] carries `organization_id`.
+      # @return [ServiceToken]
+      def get(service_token_id, organization_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/service_token/{service_token_id}",
+              "service_token_id" => service_token_id
+            ),
+            Runtime.query(
+              [
+                ["organization_id", organization_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          ServiceToken.method(:from_json)
+        )
+      end
+
+      # List service tokens
+      #
+      # @param organization_id [String] carries `organization_id`.
+      # @return [Array<ServiceToken>]
+      def list(organization_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/service_token/",
+            Runtime.query(
+              [
+                ["organization_id", organization_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(ServiceToken.method(:from_json))
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+
+    # What the API declares under `subscriptions`, issued through the transport it is handed.
+    class SubscriptionsApi
+      # @param transport [Object] what one request is issued through
+      def initialize(transport)
+        @transport = transport
+      end
+
+      # Create a new subscription
+      #
+      # @param body [SubscriptionPost] what the operation reads
+      # @return [Subscription]
+      def create(body)
+        read_answer(
+          @transport.request(
+            "POST",
+            "/api/v1/subscriptions/",
+            [],
+            body.to_h
+          ),
+          Subscription.method(:from_json)
+        )
+      end
+
+      # Delete a subscription
+      #
+      # @param subscription_id [String] carries `subscription_id`.
+      # @param application_id [String] carries `application_id`.
+      # @return [void]
+      def delete(subscription_id, application_id)
+        check_answer(
+          @transport.request(
+            "DELETE",
+            Runtime.path(
+              "/api/v1/subscriptions/{subscription_id}",
+              "subscription_id" => subscription_id
+            ),
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          )
+        )
+      end
+
+      # Get a subscription by its ID
+      #
+      # @param subscription_id [String] carries `subscription_id`.
+      # @return [Subscription]
+      def get(subscription_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            Runtime.path(
+              "/api/v1/subscriptions/{subscription_id}",
+              "subscription_id" => subscription_id
+            ),
+            [],
+            nil
+          ),
+          Subscription.method(:from_json)
+        )
+      end
+
+      # List subscriptions
+      #
+      # @param application_id [String] carries `application_id`.
+      # @return [Array<Subscription>]
+      def list(application_id)
+        read_answer(
+          @transport.request(
+            "GET",
+            "/api/v1/subscriptions/",
+            Runtime.query(
+              [
+                ["application_id", application_id]
+              ],
+              []
+            ),
+            nil
+          ),
+          Runtime.list(Subscription.method(:from_json))
+        )
+      end
+
+      # Update a subscription
+      #
+      # @param subscription_id [String] carries `subscription_id`.
+      # @param body [SubscriptionPost] what the operation reads
+      # @return [Subscription]
+      def update(subscription_id, body)
+        read_answer(
+          @transport.request(
+            "PUT",
+            Runtime.path(
+              "/api/v1/subscriptions/{subscription_id}",
+              "subscription_id" => subscription_id
+            ),
+            [],
+            body.to_h
+          ),
+          Subscription.method(:from_json)
+        )
+      end
+
+      private
+
+      # Raise what the API reported, and answer nothing when it reported nothing.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @return [void]
+      def check_answer(answered)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        nil
+      end
+
+      # Raise what the API reported, or read back the value it answered.
+      #
+      # @param answered [Array] the status and the body the transport answered
+      # @param reader [#call] what turns that body into the value the API declares
+      # @return [Object]
+      def read_answer(answered, reader)
+        status, payload = answered
+        Generated.raise_for_status(status, payload)
+        reader.call(Runtime.decode_payload(payload))
+      end
+    end
+  end
+end