Files
sdk/api_account.go

1309 lines
46 KiB
Go

/*
Hanzo Cloud API
The Hanzo Cloud API as a customer calls it: every operation under /v1/ except the operator's admin product, relay routes, legacy spellings and capabilities still reached by flag. Tagged by product: the first path segment after /v1/.
API version: v1
*/
// Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
package hanzoai
import (
"bytes"
"context"
"io"
"net/http"
"net/url"
"strings"
)
// AccountAPIService AccountAPI service
type AccountAPIService service
type AccountAPIDeleteAccountKeysByIdRequest struct {
ctx context.Context
ApiService *AccountAPIService
id string
}
func (r AccountAPIDeleteAccountKeysByIdRequest) Execute() (*AccountApiKey, *http.Response, error) {
return r.ApiService.DeleteAccountKeysByIdExecute(r)
}
/*
DeleteAccountKeysById Revokes exactly one API key, by id.
Revokes exactly one API key, by id. Every other key keeps working.
The key stays listed as revoked, with who revoked it and when, and can never be
used again. IAM refuses it at once; cloud caches a resolved key for up to 60
seconds, so a request inside that window may still be served.
A member revokes their own keys; an org admin revokes any of the org's, and
revoking someone else's is recorded on the audit trail.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param id ID is the key to act on, from the path.
@return AccountAPIDeleteAccountKeysByIdRequest
*/
func (a *AccountAPIService) DeleteAccountKeysById(ctx context.Context, id string) AccountAPIDeleteAccountKeysByIdRequest {
return AccountAPIDeleteAccountKeysByIdRequest{
ApiService: a,
ctx: ctx,
id: id,
}
}
// Execute executes the request
//
// @return AccountApiKey
func (a *AccountAPIService) DeleteAccountKeysByIdExecute(r AccountAPIDeleteAccountKeysByIdRequest) (*AccountApiKey, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodDelete
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountApiKey
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.DeleteAccountKeysById")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/keys/{id}"
localVarPath = strings.Replace(localVarPath, "{"+"id"+"}", url.PathEscape(parameterValueToString(r.id, "id")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIGetAccountAppearanceRequest struct {
ctx context.Context
ApiService *AccountAPIService
}
func (r AccountAPIGetAccountAppearanceRequest) Execute() (*AccountAppearance, *http.Response, error) {
return r.ApiService.GetAccountAppearanceExecute(r)
}
/*
GetAccountAppearance Returns the signed-in caller's own appearance preference — text size, density and accent — read from their IAM account so it is the same on every device and every Hanzo surface.
Returns the signed-in caller's own appearance preference — text
size, density and accent — read from their IAM account so it is the same on
every device and every Hanzo surface. An unset preference is an empty object.
A transient IAM read failure reports the empty preference rather than a 5xx, so
a surface applies its published default and never error-toasts on load — the
same fail-soft the key read uses.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIGetAccountAppearanceRequest
*/
func (a *AccountAPIService) GetAccountAppearance(ctx context.Context) AccountAPIGetAccountAppearanceRequest {
return AccountAPIGetAccountAppearanceRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountAppearance
func (a *AccountAPIService) GetAccountAppearanceExecute(r AccountAPIGetAccountAppearanceRequest) (*AccountAppearance, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountAppearance
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.GetAccountAppearance")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/appearance"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIGetAccountAvatarByOrgByUserByDigestRequest struct {
ctx context.Context
ApiService *AccountAPIService
org string
user string
digest string
}
func (r AccountAPIGetAccountAvatarByOrgByUserByDigestRequest) Execute() (*http.Response, error) {
return r.ApiService.GetAccountAvatarByOrgByUserByDigestExecute(r)
}
/*
GetAccountAvatarByOrgByUserByDigest Fetch a profile photo
Streams a profile photo's raw BYTES. This is the address stored on the user's IAM record and rendered directly by an `<img>`, so it takes no credentials — the 64-hex content digest in the path is the capability, and it can only be produced by someone who already has the image.
The Content-Type is derived from the stored bytes and the response carries nosniff, so only a real raster image is ever served and only under its true type. Anything else — a miss, a malformed path, an object that is not an image — is one 404, and a hit caches for a year because the address is the content.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param org
@param user
@param digest
@return AccountAPIGetAccountAvatarByOrgByUserByDigestRequest
*/
func (a *AccountAPIService) GetAccountAvatarByOrgByUserByDigest(ctx context.Context, org string, user string, digest string) AccountAPIGetAccountAvatarByOrgByUserByDigestRequest {
return AccountAPIGetAccountAvatarByOrgByUserByDigestRequest{
ApiService: a,
ctx: ctx,
org: org,
user: user,
digest: digest,
}
}
// Execute executes the request
func (a *AccountAPIService) GetAccountAvatarByOrgByUserByDigestExecute(r AccountAPIGetAccountAvatarByOrgByUserByDigestRequest) (*http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.GetAccountAvatarByOrgByUserByDigest")
if err != nil {
return nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/avatar/{org}/{user}/{digest}"
localVarPath = strings.Replace(localVarPath, "{"+"org"+"}", url.PathEscape(parameterValueToString(r.org, "org")), -1)
localVarPath = strings.Replace(localVarPath, "{"+"user"+"}", url.PathEscape(parameterValueToString(r.user, "user")), -1)
localVarPath = strings.Replace(localVarPath, "{"+"digest"+"}", url.PathEscape(parameterValueToString(r.digest, "digest")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
return localVarHTTPResponse, newErr
}
return localVarHTTPResponse, nil
}
type AccountAPIGetAccountCsrfRequest struct {
ctx context.Context
ApiService *AccountAPIService
}
func (r AccountAPIGetAccountCsrfRequest) Execute() (*AccountCsrfResp, *http.Response, error) {
return r.ApiService.GetAccountCsrfExecute(r)
}
/*
GetAccountCsrf Mints the anti-forgery token a browser echoes as X-CSRF-Token on every change it asks for.
Mints the anti-forgery token a browser echoes as X-CSRF-Token on
every change it asks for. The token is bound to the caller's validated identity
and expires, so one minted for one identity cannot authorize a change as another.
It is answered no-store, so it is never cached by a shared proxy. This is the
same-origin endpoint the embedded console reads — the Same-Origin Policy is what
stops a cross-site page from reading the response and forging a change.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIGetAccountCsrfRequest
*/
func (a *AccountAPIService) GetAccountCsrf(ctx context.Context) AccountAPIGetAccountCsrfRequest {
return AccountAPIGetAccountCsrfRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountCsrfResp
func (a *AccountAPIService) GetAccountCsrfExecute(r AccountAPIGetAccountCsrfRequest) (*AccountCsrfResp, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountCsrfResp
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.GetAccountCsrf")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/csrf"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIGetAccountEmbedRequest struct {
ctx context.Context
ApiService *AccountAPIService
app *string
}
// App is the embedded app to report on: cms (Content Studio), erp or help.
func (r AccountAPIGetAccountEmbedRequest) App(app string) AccountAPIGetAccountEmbedRequest {
r.app = &app
return r
}
func (r AccountAPIGetAccountEmbedRequest) Execute() (*AccountEmbedStatusResp, *http.Response, error) {
return r.ApiService.GetAccountEmbedExecute(r)
}
/*
GetAccountEmbed Reports whether one of this brand's shared embedded apps (cms, erp, help) may be framed by the caller and is actually running, so a console module can choose between the embed and the provision panel.
Reports whether one of this brand's shared embedded apps (cms, erp,
help) may be framed by the caller and is actually running, so a console module
can choose between the embed and the provision panel.
It answers two questions the browser cannot answer for itself. ENTITLEMENT is
server-authoritative: each app is a single shared per-BRAND instance, so only a
member of the owning brand org — or a SuperAdmin — is given the embed URL; every
other caller gets phase "not-entitled" and no URL. REACHABILITY is a probe of
that origin, which a cross-origin page cannot read for itself.
The probed host is always <app>.<this deployment's own brand domain>: no part of
it comes from the request, so this can never be steered into probing an
arbitrary origin.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIGetAccountEmbedRequest
*/
func (a *AccountAPIService) GetAccountEmbed(ctx context.Context) AccountAPIGetAccountEmbedRequest {
return AccountAPIGetAccountEmbedRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountEmbedStatusResp
func (a *AccountAPIService) GetAccountEmbedExecute(r AccountAPIGetAccountEmbedRequest) (*AccountEmbedStatusResp, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountEmbedStatusResp
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.GetAccountEmbed")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/embed"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.app != nil {
parameterAddToHeaderOrQuery(localVarQueryParams, "app", r.app, "form", "")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIGetAccountKeysRequest struct {
ctx context.Context
ApiService *AccountAPIService
}
func (r AccountAPIGetAccountKeysRequest) Execute() (*AccountApiKeyList, *http.Response, error) {
return r.ApiService.GetAccountKeysExecute(r)
}
/*
GetAccountKeys Returns the API keys the caller may see, newest first: their own, or every key the org holds when the caller administers it.
Returns the API keys the caller may see, newest first: their own, or
every key the org holds when the caller administers it. Each is its own
credential with its own name, prefix, status, expiry and limit. Revoked keys
stay listed. No secret material comes back; a publishable key, which is public
by construction, carries its full value.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIGetAccountKeysRequest
*/
func (a *AccountAPIService) GetAccountKeys(ctx context.Context) AccountAPIGetAccountKeysRequest {
return AccountAPIGetAccountKeysRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountApiKeyList
func (a *AccountAPIService) GetAccountKeysExecute(r AccountAPIGetAccountKeysRequest) (*AccountApiKeyList, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodGet
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountApiKeyList
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.GetAccountKeys")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/keys"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIPatchAccountKeysByIdRequest struct {
ctx context.Context
ApiService *AccountAPIService
id string
accountKeyEdit *AccountKeyEdit
}
func (r AccountAPIPatchAccountKeysByIdRequest) AccountKeyEdit(accountKeyEdit AccountKeyEdit) AccountAPIPatchAccountKeysByIdRequest {
r.accountKeyEdit = &accountKeyEdit
return r
}
func (r AccountAPIPatchAccountKeysByIdRequest) Execute() (*AccountApiKey, *http.Response, error) {
return r.ApiService.PatchAccountKeysByIdExecute(r)
}
/*
PatchAccountKeysById Changes one key's name, permissions, budget, rate or expiry.
Changes one key's name, permissions, budget, rate or expiry. The secret
is not reissued: the key in your deployment keeps working, under its new
policy. Only the person the key belongs to may edit it, and a revoked key
cannot be edited.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@param id ID is the key to edit, from the path.
@return AccountAPIPatchAccountKeysByIdRequest
*/
func (a *AccountAPIService) PatchAccountKeysById(ctx context.Context, id string) AccountAPIPatchAccountKeysByIdRequest {
return AccountAPIPatchAccountKeysByIdRequest{
ApiService: a,
ctx: ctx,
id: id,
}
}
// Execute executes the request
//
// @return AccountApiKey
func (a *AccountAPIService) PatchAccountKeysByIdExecute(r AccountAPIPatchAccountKeysByIdRequest) (*AccountApiKey, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPatch
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountApiKey
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.PatchAccountKeysById")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/keys/{id}"
localVarPath = strings.Replace(localVarPath, "{"+"id"+"}", url.PathEscape(parameterValueToString(r.id, "id")), -1)
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.accountKeyEdit == nil {
return localVarReturnValue, nil, reportError("accountKeyEdit is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.accountKeyEdit
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIPostAccountAppearanceRequest struct {
ctx context.Context
ApiService *AccountAPIService
accountAppearance *AccountAppearance
}
func (r AccountAPIPostAccountAppearanceRequest) AccountAppearance(accountAppearance AccountAppearance) AccountAPIPostAccountAppearanceRequest {
r.accountAppearance = &accountAppearance
return r
}
func (r AccountAPIPostAccountAppearanceRequest) Execute() (*AccountAppearance, *http.Response, error) {
return r.ApiService.PostAccountAppearanceExecute(r)
}
/*
PostAccountAppearance Stores the caller's appearance preference on their IAM account, preserving every other field of the row.
Stores the caller's appearance preference on their IAM account,
preserving every other field of the row. The accent is validated as a real
colour token before it is stored; an unset or invalid axis is dropped rather
than stored.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIPostAccountAppearanceRequest
*/
func (a *AccountAPIService) PostAccountAppearance(ctx context.Context) AccountAPIPostAccountAppearanceRequest {
return AccountAPIPostAccountAppearanceRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountAppearance
func (a *AccountAPIService) PostAccountAppearanceExecute(r AccountAPIPostAccountAppearanceRequest) (*AccountAppearance, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountAppearance
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.PostAccountAppearance")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/appearance"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.accountAppearance == nil {
return localVarReturnValue, nil, reportError("accountAppearance is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.accountAppearance
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIPostAccountAvatarRequest struct {
ctx context.Context
ApiService *AccountAPIService
}
func (r AccountAPIPostAccountAvatarRequest) Execute() (*http.Response, error) {
return r.ApiService.PostAccountAvatarExecute(r)
}
/*
PostAccountAvatar Set your profile photo
Stores one image as the signed-in user's profile photo and answers the URL it is served from, which is also written to the user's IAM record — so every surface that already renders `avatar` picks it up with no further call.
The body is a multipart form with a `file` part. The format is decided by the BYTES, never the filename or the part's Content-Type: png, jpeg, gif and webp are accepted and everything else is refused with 415, so an SVG cannot be stored as a picture and later served as a program. Over 8 MiB is 413; empty is 400.
The photo is addressed by the sha256 of its bytes, so setting a new one yields a new URL rather than a stale cache of the old face. The caller is taken from the validated identity ONLY — there is no way to name a different subject — so this always sets your own photo, and a caller with no organization yet is refused.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIPostAccountAvatarRequest
*/
func (a *AccountAPIService) PostAccountAvatar(ctx context.Context) AccountAPIPostAccountAvatarRequest {
return AccountAPIPostAccountAvatarRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
func (a *AccountAPIService) PostAccountAvatarExecute(r AccountAPIPostAccountAvatarRequest) (*http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.PostAccountAvatar")
if err != nil {
return nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/avatar"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
return localVarHTTPResponse, newErr
}
return localVarHTTPResponse, nil
}
type AccountAPIPostAccountKeysRequest struct {
ctx context.Context
ApiService *AccountAPIService
accountKeyIn *AccountKeyIn
}
func (r AccountAPIPostAccountKeysRequest) AccountKeyIn(accountKeyIn AccountKeyIn) AccountAPIPostAccountKeysRequest {
r.accountKeyIn = &accountKeyIn
return r
}
func (r AccountAPIPostAccountKeysRequest) Execute() (*AccountApiKey, *http.Response, error) {
return r.ApiService.PostAccountKeysExecute(r)
}
/*
PostAccountKeys Creates a NEW API key and returns its secret ONCE.
Creates a NEW API key and returns its secret ONCE. It never revokes
or changes any other key: every key the caller already holds keeps working.
The key is filed in the org the caller acts in and names them as its creator.
An org holds at most 1,000 live keys; past that the create is refused until one
is revoked.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIPostAccountKeysRequest
*/
func (a *AccountAPIService) PostAccountKeys(ctx context.Context) AccountAPIPostAccountKeysRequest {
return AccountAPIPostAccountKeysRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountApiKey
func (a *AccountAPIService) PostAccountKeysExecute(r AccountAPIPostAccountKeysRequest) (*AccountApiKey, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountApiKey
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.PostAccountKeys")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/keys"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.accountKeyIn == nil {
return localVarReturnValue, nil, reportError("accountKeyIn is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.accountKeyIn
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}
type AccountAPIPostAccountOrgsRequest struct {
ctx context.Context
ApiService *AccountAPIService
accountOnboardReq *AccountOnboardReq
}
func (r AccountAPIPostAccountOrgsRequest) AccountOnboardReq(accountOnboardReq AccountOnboardReq) AccountAPIPostAccountOrgsRequest {
r.accountOnboardReq = &accountOnboardReq
return r
}
func (r AccountAPIPostAccountOrgsRequest) Execute() (*AccountOnboardResp, *http.Response, error) {
return r.ApiService.PostAccountOrgsExecute(r)
}
/*
PostAccountOrgs Creates an organization and makes the caller its owner.
Creates an organization and makes the caller its owner.
The caller's own account is not touched: who they are, the org their account
lives in and how they sign in are the same before and after. The new org is a
separate organization they belong to by membership, carried in the signed
`orgs` claim of their next token, and reached by selecting it (X-Org-Id, the
org switcher). Teammates join it the same way. The org starts at a zero
balance, and its default API key is minted for the creator and returned once.
Moving the creator into the org instead re-keyed their identity to
"<org>/<name>", and sign-in, which resolves an address in the signup org,
then found nobody: the person was offered a second account for their own
address.
@param ctx context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
@return AccountAPIPostAccountOrgsRequest
*/
func (a *AccountAPIService) PostAccountOrgs(ctx context.Context) AccountAPIPostAccountOrgsRequest {
return AccountAPIPostAccountOrgsRequest{
ApiService: a,
ctx: ctx,
}
}
// Execute executes the request
//
// @return AccountOnboardResp
func (a *AccountAPIService) PostAccountOrgsExecute(r AccountAPIPostAccountOrgsRequest) (*AccountOnboardResp, *http.Response, error) {
var (
localVarHTTPMethod = http.MethodPost
localVarPostBody interface{}
formFiles []formFile
localVarReturnValue *AccountOnboardResp
)
localBasePath, err := a.client.cfg.ServerURLWithContext(r.ctx, "AccountAPIService.PostAccountOrgs")
if err != nil {
return localVarReturnValue, nil, &GenericOpenAPIError{error: err.Error()}
}
localVarPath := localBasePath + "/v1/account/orgs"
localVarHeaderParams := make(map[string]string)
localVarQueryParams := url.Values{}
localVarFormParams := url.Values{}
if r.accountOnboardReq == nil {
return localVarReturnValue, nil, reportError("accountOnboardReq is required and must be specified")
}
// to determine the Content-Type header
localVarHTTPContentTypes := []string{"application/json"}
// set Content-Type header
localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
if localVarHTTPContentType != "" {
localVarHeaderParams["Content-Type"] = localVarHTTPContentType
}
// to determine the Accept header
localVarHTTPHeaderAccepts := []string{"application/json", "application/problem+json"}
// set Accept header
localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
if localVarHTTPHeaderAccept != "" {
localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
}
// body params
localVarPostBody = r.accountOnboardReq
req, err := a.client.prepareRequest(r.ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, formFiles)
if err != nil {
return localVarReturnValue, nil, err
}
localVarHTTPResponse, err := a.client.callAPI(req)
if err != nil || localVarHTTPResponse == nil {
return localVarReturnValue, localVarHTTPResponse, err
}
localVarBody, err := io.ReadAll(localVarHTTPResponse.Body)
localVarHTTPResponse.Body.Close()
localVarHTTPResponse.Body = io.NopCloser(bytes.NewBuffer(localVarBody))
if err != nil {
return localVarReturnValue, localVarHTTPResponse, err
}
if localVarHTTPResponse.StatusCode >= 300 {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: localVarHTTPResponse.Status,
}
var v ProblemDetails
err = a.client.decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr.error = err.Error()
return localVarReturnValue, localVarHTTPResponse, newErr
}
newErr.error = formatErrorMessage(localVarHTTPResponse.Status, &v)
newErr.model = v
return localVarReturnValue, localVarHTTPResponse, newErr
}
err = a.client.decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
if err != nil {
newErr := &GenericOpenAPIError{
body: localVarBody,
error: err.Error(),
}
return localVarReturnValue, localVarHTTPResponse, newErr
}
return localVarReturnValue, localVarHTTPResponse, nil
}