package io.apibuilder.api.v0.models;

import java.lang.Long;
import java.lang.String;
import java.lang.Void;
import java.util.UUID;
import retrofit2.Call;
import retrofit2.http.Body;
import retrofit2.http.DELETE;
import retrofit2.http.GET;
import retrofit2.http.POST;
import retrofit2.http.PUT;
import retrofit2.http.Path;
import retrofit2.http.Query;

/**
 * Generated by API Builder - https://www.apibuilder.io
 * Service version: 0.14.3-46-g35788525
 * User agent: apibuilder app.apibuilder.io/apicollective/apibuilder-api/0.14.3-46-g35788525/android_client
 *
 * WARNING: not all features (notably unions) and data types work with android generator yet.  
 * Android generator is designed to be used in an android application, but should work in any java codebase as long as you import jackson and retrofit2 libraries.  
 * If you are considering using this library, would like to request/discuss features, or would like to share how you're using it, please contact android-feedback@gilt.com 
 *
 */
public interface OrganizationsClient {
  /**
   * Search all organizations. Results are always paginated.
   */
  @GET("organizations")
  Call<Organization[]> getOrganizations(@Query("guid") UUID guid, @Query("user_guid") UUID userGuid,
      @Query("key") String key, @Query("name") String name, @Query("namespace") String namespace,
      @Query("limit") Long limit, @Query("offset") Long offset);

  /**
   * Returns the organization with this key.
   */
  @GET("organizations/{key}")
  Call<Organization> getOrganizationsKey(@Path("key") String key);

  /**
   * Create a new organization.
   */
  @POST("organizations")
  Call<Organization> postOrganizations(@Body OrganizationForm organizationForm);

  /**
   * Update an organization.
   */
  @PUT("organizations/{key}")
  Call<Organization> putOrganizationsKey(@Body OrganizationForm organizationForm,
      @Path("key") String key);

  /**
   * Deletes an organization and all of its associated applications.
   */
  @DELETE("organizations/{key}")
  Call<Void> deleteOrganizationsKey(@Path("key") String key);

  /**
   * Returns all attribute values for this organization. Results are always paginated.
   */
  @GET("organizations/{key}/attributes")
  Call<AttributeValue[]> getOrganizationsKeyAttributes(@Path("key") String key,
      @Query("name") String name, @Query("limit") Long limit, @Query("offset") Long offset);

  /**
   * Returns the attribute value with this name.
   */
  @GET("organizations/{key}/attributes/{name}")
  Call<AttributeValue> getOrganizationsKeyAttributesName(@Path("key") String key,
      @Path("name") String name);

  /**
   * Create or update a new attribute value.
   */
  @PUT("organizations/{key}/attributes/{name}")
  Call<AttributeValue> putOrganizationsKeyAttributesName(
      @Body AttributeValueForm attributeValueForm, @Path("key") String key,
      @Path("name") String name);

  /**
   * Deletes the attribute value with the specified name. Only the user who created an attribute value can delete it.
   */
  @DELETE("organizations/{key}/attributes/{name}")
  Call<Void> deleteOrganizationsKeyAttributesName(@Path("key") String key,
      @Path("name") String name);
}