serval

package module
v0.14.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jan 29, 2026 License: Apache-2.0 Imports: 17 Imported by: 0

README

Serval Go API Library

Go Reference

The Serval Go library provides convenient access to the Serval REST API from applications written in Go.

Installation

import (
	"github.com/ServalHQ/serval-go" // imported as serval
)

Or to pin the version:

go get -u 'github.com/ServalHQ/serval-go@v0.14.0'

Requirements

This library requires Go 1.22+.

Usage

The full API of this library can be found in api.md.

package main

import (
	"context"
	"fmt"

	"github.com/ServalHQ/serval-go"
)

func main() {
	client := serval.NewClient()
	accessPolicy, err := client.AccessPolicies.New(context.TODO(), serval.AccessPolicyNewParams{
		Name:   "Example Access Policy",
		TeamID: "teamId",
	})
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", accessPolicy.ID)
}
Request fields

The serval library uses the omitzero semantics from the Go 1.24+ encoding/json release for request fields.

Required primitive fields (int64, string, etc.) feature the tag `json:"...,required"`. These fields are always serialized, even their zero values.

Optional primitive types are wrapped in a param.Opt[T]. These fields can be set with the provided constructors, serval.String(string), serval.Int(int64), etc.

Any param.Opt[T], map, slice, struct or string enum uses the tag `json:"...,omitzero"`. Its zero value is considered omitted.

The param.IsOmitted(any) function can confirm the presence of any omitzero field.

p := serval.ExampleParams{
	ID:   "id_xxx",             // required property
	Name: serval.String("..."), // optional property

	Point: serval.Point{
		X: 0,             // required field will serialize as 0
		Y: serval.Int(1), // optional field will serialize as 1
		// ... omitted non-required fields will not be serialized
	},

	Origin: serval.Origin{}, // the zero value of [Origin] is considered omitted
}

To send null instead of a param.Opt[T], use param.Null[T](). To send null instead of a struct T, use param.NullStruct[T]().

p.Name = param.Null[string]()       // 'null' instead of string
p.Point = param.NullStruct[Point]() // 'null' instead of struct

param.IsNull(p.Name)  // true
param.IsNull(p.Point) // true

Request structs contain a .SetExtraFields(map[string]any) method which can send non-conforming fields in the request body. Extra fields overwrite any struct fields with a matching key. For security reasons, only use SetExtraFields with trusted data.

To send a custom value instead of a struct, use param.Override[T](value).

// In cases where the API specifies a given type,
// but you want to send something else, use [SetExtraFields]:
p.SetExtraFields(map[string]any{
	"x": 0.01, // send "x" as a float instead of int
})

// Send a number instead of an object
custom := param.Override[serval.FooParams](12)
Request unions

Unions are represented as a struct with fields prefixed by "Of" for each of its variants, only one field can be non-zero. The non-zero field will be serialized.

Sub-properties of the union can be accessed via methods on the union struct. These methods return a mutable pointer to the underlying data, if present.

// Only one field can be non-zero, use param.IsOmitted() to check if a field is set
type AnimalUnionParam struct {
	OfCat *Cat `json:",omitzero,inline`
	OfDog *Dog `json:",omitzero,inline`
}

animal := AnimalUnionParam{
	OfCat: &Cat{
		Name: "Whiskers",
		Owner: PersonParam{
			Address: AddressParam{Street: "3333 Coyote Hill Rd", Zip: 0},
		},
	},
}

// Mutating a field
if address := animal.GetOwner().GetAddress(); address != nil {
	address.ZipCode = 94304
}
Response objects

All fields in response structs are ordinary value types (not pointers or wrappers). Response structs also include a special JSON field containing metadata about each property.

type Animal struct {
	Name   string `json:"name,nullable"`
	Owners int    `json:"owners"`
	Age    int    `json:"age"`
	JSON   struct {
		Name        respjson.Field
		Owner       respjson.Field
		Age         respjson.Field
		ExtraFields map[string]respjson.Field
	} `json:"-"`
}

To handle optional data, use the .Valid() method on the JSON field. .Valid() returns true if a field is not null, not present, or couldn't be marshaled.

If .Valid() is false, the corresponding field will simply be its zero value.

raw := `{"owners": 1, "name": null}`

var res Animal
json.Unmarshal([]byte(raw), &res)

// Accessing regular fields

res.Owners // 1
res.Name   // ""
res.Age    // 0

// Optional field checks

res.JSON.Owners.Valid() // true
res.JSON.Name.Valid()   // false
res.JSON.Age.Valid()    // false

// Raw JSON values

res.JSON.Owners.Raw()                  // "1"
res.JSON.Name.Raw() == "null"          // true
res.JSON.Name.Raw() == respjson.Null   // true
res.JSON.Age.Raw() == ""               // true
res.JSON.Age.Raw() == respjson.Omitted // true

These .JSON structs also include an ExtraFields map containing any properties in the json response that were not specified in the struct. This can be useful for API features not yet present in the SDK.

body := res.JSON.ExtraFields["my_unexpected_field"].Raw()
Response Unions

In responses, unions are represented by a flattened struct containing all possible fields from each of the object variants. To convert it to a variant use the .AsFooVariant() method or the .AsAny() method if present.

If a response value union contains primitive values, primitive fields will be alongside the properties but prefixed with Of and feature the tag json:"...,inline".

type AnimalUnion struct {
	// From variants [Dog], [Cat]
	Owner Person `json:"owner"`
	// From variant [Dog]
	DogBreed string `json:"dog_breed"`
	// From variant [Cat]
	CatBreed string `json:"cat_breed"`
	// ...

	JSON struct {
		Owner respjson.Field
		// ...
	} `json:"-"`
}

// If animal variant
if animal.Owner.Address.ZipCode == "" {
	panic("missing zip code")
}

// Switch on the variant
switch variant := animal.AsAny().(type) {
case Dog:
case Cat:
default:
	panic("unexpected type")
}
RequestOptions

This library uses the functional options pattern. Functions defined in the option package return a RequestOption, which is a closure that mutates a RequestConfig. These options can be supplied to the client or at individual requests. For example:

client := serval.NewClient(
	// Adds a header to every request made by the client
	option.WithHeader("X-Some-Header", "custom_header_info"),
)

client.AccessPolicies.List(context.TODO(), ...,
	// Override the header
	option.WithHeader("X-Some-Header", "some_other_custom_header_info"),
	// Add an undocumented field to the request body, using sjson syntax
	option.WithJSONSet("some.json.path", map[string]string{"my": "object"}),
)

The request option option.WithDebugLog(nil) may be helpful while debugging.

See the full list of request options.

Pagination

This library provides some conveniences for working with paginated list endpoints.

You can use .ListAutoPaging() methods to iterate through items across all pages:

Or you can use simple .List() methods to fetch a single page and receive a standard response object with additional helper methods like .GetNextPage(), e.g.:

Errors

When the API returns a non-success status code, we return an error with type *serval.Error. This contains the StatusCode, *http.Request, and *http.Response values of the request, as well as the JSON of the error body (much like other response objects in the SDK).

To handle errors, we recommend that you use the errors.As pattern:

_, err := client.AccessPolicies.Get(context.TODO(), "nonexistent-id")
if err != nil {
	var apierr *serval.Error
	if errors.As(err, &apierr) {
		println(string(apierr.DumpRequest(true)))  // Prints the serialized HTTP request
		println(string(apierr.DumpResponse(true))) // Prints the serialized HTTP response
	}
	panic(err.Error()) // GET "/v2/access-policies/{id}": 400 Bad Request { ... }
}

When other errors occur, they are returned unwrapped; for example, if HTTP transport fails, you might receive *url.Error wrapping *net.OpError.

Timeouts

Requests do not time out by default; use context to configure a timeout for a request lifecycle.

Note that if a request is retried, the context timeout does not start over. To set a per-retry timeout, use option.WithRequestTimeout().

// This sets the timeout for the request, including all the retries.
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)
defer cancel()
client.AccessPolicies.List(
	ctx,
	serval.AccessPolicyListParams{},
	// This sets the per-retry timeout
	option.WithRequestTimeout(20*time.Second),
)
File uploads

Request parameters that correspond to file uploads in multipart requests are typed as io.Reader. The contents of the io.Reader will by default be sent as a multipart form part with the file name of "anonymous_file" and content-type of "application/octet-stream".

The file name and content-type can be customized by implementing Name() string or ContentType() string on the run-time type of io.Reader. Note that os.File implements Name() string, so a file returned by os.Open will be sent with the file name on disk.

We also provide a helper serval.File(reader io.Reader, filename string, contentType string) which can be used to wrap any io.Reader with the appropriate file name and content type.

Retries

Certain errors will be automatically retried 2 times by default, with a short exponential backoff. We retry by default all connection errors, 408 Request Timeout, 409 Conflict, 429 Rate Limit, and >=500 Internal errors.

You can use the WithMaxRetries option to configure or disable this:

// Configure the default for all requests:
client := serval.NewClient(
	option.WithMaxRetries(0), // default is 2
)

// Override per-request:
client.AccessPolicies.List(
	context.TODO(),
	serval.AccessPolicyListParams{},
	option.WithMaxRetries(5),
)
Accessing raw response data (e.g. response headers)

You can access the raw HTTP response data by using the option.WithResponseInto() request option. This is useful when you need to examine response headers, status codes, or other details.

// Create a variable to store the HTTP response
var response *http.Response
accessPolicies, err := client.AccessPolicies.List(
	context.TODO(),
	serval.AccessPolicyListParams{},
	option.WithResponseInto(&response),
)
if err != nil {
	// handle error
}
fmt.Printf("%+v\n", accessPolicies)

fmt.Printf("Status Code: %d\n", response.StatusCode)
fmt.Printf("Headers: %+#v\n", response.Header)
Making custom/undocumented requests

This library is typed for convenient access to the documented API. If you need to access undocumented endpoints, params, or response properties, the library can still be used.

Undocumented endpoints

To make requests to undocumented endpoints, you can use client.Get, client.Post, and other HTTP verbs. RequestOptions on the client, such as retries, will be respected when making these requests.

var (
    // params can be an io.Reader, a []byte, an encoding/json serializable object,
    // or a "…Params" struct defined in this library.
    params map[string]any

    // result can be an []byte, *http.Response, a encoding/json deserializable object,
    // or a model defined in this library.
    result *http.Response
)
err := client.Post(context.Background(), "/unspecified", params, &result)
if err != nil {
    …
}
Undocumented request params

To make requests using undocumented parameters, you may use either the option.WithQuerySet() or the option.WithJSONSet() methods.

params := FooNewParams{
    ID:   "id_xxxx",
    Data: FooNewParamsData{
        FirstName: serval.String("John"),
    },
}
client.Foo.New(context.Background(), params, option.WithJSONSet("data.last_name", "Doe"))
Undocumented response properties

To access undocumented response properties, you may either access the raw JSON of the response as a string with result.JSON.RawJSON(), or get the raw JSON of a particular field on the result with result.JSON.Foo.Raw().

Any fields that are not present on the response struct will be saved and can be accessed by result.JSON.ExtraFields() which returns the extra fields as a map[string]Field.

Middleware

We provide option.WithMiddleware which applies the given middleware to requests.

func Logger(req *http.Request, next option.MiddlewareNext) (res *http.Response, err error) {
	// Before the request
	start := time.Now()
	LogReq(req)

	// Forward the request to the next handler
	res, err = next(req)

	// Handle stuff after the request
	end := time.Now()
	LogRes(res, err, start - end)

    return res, err
}

client := serval.NewClient(
	option.WithMiddleware(Logger),
)

When multiple middlewares are provided as variadic arguments, the middlewares are applied left to right. If option.WithMiddleware is given multiple times, for example first in the client then the method, the middleware in the client will run first and the middleware given in the method will run next.

You may also replace the default http.Client with option.WithHTTPClient(client). Only one http client is accepted (this overwrites any previous client) and receives requests after any middleware has been applied.

Semantic versioning

This package generally follows SemVer conventions, though certain backwards-incompatible changes may be released as minor versions:

  1. Changes to library internals which are technically public but not intended or documented for external use. (Please open a GitHub issue to let us know if you are relying on such internals.)
  2. Changes that we do not expect to impact the vast majority of users in practice.

We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.

We are keen for your feedback; please open an issue with questions, bugs, or suggestions.

Contributing

See the contributing documentation.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Bool 

func Bool(b bool) param.Opt[bool]

func BoolPtr 

func BoolPtr(v bool) *bool

func DefaultClientOptions 

func DefaultClientOptions() []option.RequestOption

DefaultClientOptions read from the environment (SERVAL_CLIENT_ID, SERVAL_CLIENT_SECRET, SERVAL_BASE_URL). This should be used to initialize new clients.

func File 

func File(rdr io.Reader, filename string, contentType string) file

func Float 

func Float(f float64) param.Opt[float64]

func FloatPtr 

func FloatPtr(v float64) *float64

func Int 

func Int(i int64) param.Opt[int64]

func IntPtr 

func IntPtr(v int64) *int64

func Opt 

func Opt[T comparable](v T) param.Opt[T]

func Ptr 

func Ptr[T any](v T) *T

func String 

func String(s string) param.Opt[string]

func StringPtr 

func StringPtr(v string) *string

func Time 

func Time(t time.Time) param.Opt[time.Time]

func TimePtr 

func TimePtr(v time.Time) *time.Time

Types

type AccessPolicy 

type AccessPolicy struct {
	// The ID of the access policy.
	ID string `json:"id"`
	// A description of the access policy.
	Description string `json:"description"`
	// The maximum number of minutes that access can be granted for.
	MaxAccessMinutes int64 `json:"maxAccessMinutes"`
	// The name of the access policy.
	Name string `json:"name"`
	// The recommended duration in minutes for access requests (optional).
	RecommendedAccessMinutes int64 `json:"recommendedAccessMinutes,nullable"`
	// Whether a business justification is required when requesting access.
	RequireBusinessJustification bool `json:"requireBusinessJustification"`
	// The ID of the team that the access policy belongs to.
	TeamID string `json:"teamId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                           respjson.Field
		Description                  respjson.Field
		MaxAccessMinutes             respjson.Field
		Name                         respjson.Field
		RecommendedAccessMinutes     respjson.Field
		RequireBusinessJustification respjson.Field
		TeamID                       respjson.Field
		ExtraFields                  map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicy) RawJSON 

func (r AccessPolicy) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicy) UnmarshalJSON 

func (r *AccessPolicy) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedure 

type AccessPolicyApprovalProcedure struct {
	// The ID of the access policy approval procedure.
	ID string `json:"id"`
	// The ID of the access policy this approval procedure belongs to.
	AccessPolicyID string `json:"accessPolicyId"`
	// The steps in the approval procedure.
	Steps []AccessPolicyApprovalProcedureStep `json:"steps"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID             respjson.Field
		AccessPolicyID respjson.Field
		Steps          respjson.Field
		ExtraFields    map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedure) RawJSON 

func (r AccessPolicyApprovalProcedure) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedure) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedure) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureDeleteParams 

type AccessPolicyApprovalProcedureDeleteParams struct {
	// The ID of the access policy.
	AccessPolicyID string `path:"access_policy_id,required" json:"-"`
	// contains filtered or unexported fields
}

type AccessPolicyApprovalProcedureDeleteResponse 

type AccessPolicyApprovalProcedureDeleteResponse = any

type AccessPolicyApprovalProcedureGetParams 

type AccessPolicyApprovalProcedureGetParams struct {
	// The ID of the access policy.
	AccessPolicyID string `path:"access_policy_id,required" json:"-"`
	// contains filtered or unexported fields
}

type AccessPolicyApprovalProcedureGetResponseEnvelope 

type AccessPolicyApprovalProcedureGetResponseEnvelope struct {
	// The approval procedure.
	Data AccessPolicyApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedureGetResponseEnvelope) RawJSON 

func (r AccessPolicyApprovalProcedureGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedureGetResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureGetResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureListResponseEnvelope 

type AccessPolicyApprovalProcedureListResponseEnvelope struct {
	// The list of approval procedures (typically 0 or 1).
	Data []AccessPolicyApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedureListResponseEnvelope) RawJSON 

func (r AccessPolicyApprovalProcedureListResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedureListResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureListResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureNewParams 

type AccessPolicyApprovalProcedureNewParams struct {
	// The approval steps for the procedure.
	Steps []AccessPolicyApprovalProcedureNewParamsStep `json:"steps,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyApprovalProcedureNewParams) MarshalJSON 

func (r AccessPolicyApprovalProcedureNewParams) MarshalJSON() (data []byte, err error)

func (*AccessPolicyApprovalProcedureNewParams) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureNewParams) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureNewParamsStep 

type AccessPolicyApprovalProcedureNewParamsStep struct {
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval param.Opt[bool] `json:"allowSelfApproval,omitzero"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID param.Opt[string] `json:"customWorkflowId,omitzero"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds,omitzero"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyApprovalProcedureNewParamsStep) MarshalJSON 

func (r AccessPolicyApprovalProcedureNewParamsStep) MarshalJSON() (data []byte, err error)

func (*AccessPolicyApprovalProcedureNewParamsStep) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureNewParamsStep) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureNewResponseEnvelope 

type AccessPolicyApprovalProcedureNewResponseEnvelope struct {
	// The created approval procedure.
	Data AccessPolicyApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedureNewResponseEnvelope) RawJSON 

func (r AccessPolicyApprovalProcedureNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedureNewResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureNewResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureService 

type AccessPolicyApprovalProcedureService struct {
	Options []option.RequestOption
}

AccessPolicyApprovalProcedureService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAccessPolicyApprovalProcedureService method instead.

func NewAccessPolicyApprovalProcedureService 

func NewAccessPolicyApprovalProcedureService(opts ...option.RequestOption) (r AccessPolicyApprovalProcedureService)

NewAccessPolicyApprovalProcedureService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*AccessPolicyApprovalProcedureService) Delete 

func (r *AccessPolicyApprovalProcedureService) Delete(ctx context.Context, id string, body AccessPolicyApprovalProcedureDeleteParams, opts ...option.RequestOption) (res *AccessPolicyApprovalProcedureDeleteResponse, err error)

Delete an approval procedure for an access policy.

func (*AccessPolicyApprovalProcedureService) Get 

func (r *AccessPolicyApprovalProcedureService) Get(ctx context.Context, id string, query AccessPolicyApprovalProcedureGetParams, opts ...option.RequestOption) (res *AccessPolicyApprovalProcedure, err error)

Get a specific approval procedure by ID for an access policy.

func (*AccessPolicyApprovalProcedureService) List 

func (r *AccessPolicyApprovalProcedureService) List(ctx context.Context, accessPolicyID string, opts ...option.RequestOption) (res *[]AccessPolicyApprovalProcedure, err error)

List all approval procedures for an access policy.

func (*AccessPolicyApprovalProcedureService) New 

func (r *AccessPolicyApprovalProcedureService) New(ctx context.Context, accessPolicyID string, body AccessPolicyApprovalProcedureNewParams, opts ...option.RequestOption) (res *AccessPolicyApprovalProcedure, err error)

Create a new approval procedure for an access policy.

func (*AccessPolicyApprovalProcedureService) Update 

func (r *AccessPolicyApprovalProcedureService) Update(ctx context.Context, id string, params AccessPolicyApprovalProcedureUpdateParams, opts ...option.RequestOption) (res *AccessPolicyApprovalProcedure, err error)

Update an existing approval procedure for an access policy.

type AccessPolicyApprovalProcedureStep 

type AccessPolicyApprovalProcedureStep struct {
	// The ID of the approval step.
	ID string `json:"id"`
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval bool `json:"allowSelfApproval"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID string `json:"customWorkflowId"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                respjson.Field
		AllowSelfApproval respjson.Field
		CustomWorkflowID  respjson.Field
		ServalGroupIDs    respjson.Field
		SpecificUserIDs   respjson.Field
		ExtraFields       map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedureStep) RawJSON 

func (r AccessPolicyApprovalProcedureStep) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedureStep) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureStep) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureUpdateParams 

type AccessPolicyApprovalProcedureUpdateParams struct {
	// The ID of the access policy.
	AccessPolicyID string `path:"access_policy_id,required" json:"-"`
	// The approval steps for the procedure.
	Steps []AccessPolicyApprovalProcedureUpdateParamsStep `json:"steps,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyApprovalProcedureUpdateParams) MarshalJSON 

func (r AccessPolicyApprovalProcedureUpdateParams) MarshalJSON() (data []byte, err error)

func (*AccessPolicyApprovalProcedureUpdateParams) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureUpdateParams) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureUpdateParamsStep 

type AccessPolicyApprovalProcedureUpdateParamsStep struct {
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval param.Opt[bool] `json:"allowSelfApproval,omitzero"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID param.Opt[string] `json:"customWorkflowId,omitzero"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds,omitzero"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyApprovalProcedureUpdateParamsStep) MarshalJSON 

func (r AccessPolicyApprovalProcedureUpdateParamsStep) MarshalJSON() (data []byte, err error)

func (*AccessPolicyApprovalProcedureUpdateParamsStep) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureUpdateParamsStep) UnmarshalJSON(data []byte) error

type AccessPolicyApprovalProcedureUpdateResponseEnvelope 

type AccessPolicyApprovalProcedureUpdateResponseEnvelope struct {
	// The updated approval procedure.
	Data AccessPolicyApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyApprovalProcedureUpdateResponseEnvelope) RawJSON 

func (r AccessPolicyApprovalProcedureUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyApprovalProcedureUpdateResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyApprovalProcedureUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyDeleteResponse 

type AccessPolicyDeleteResponse = any

type AccessPolicyGetResponseEnvelope 

type AccessPolicyGetResponseEnvelope struct {
	// The access policy.
	Data AccessPolicy `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyGetResponseEnvelope) RawJSON 

func (r AccessPolicyGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyGetResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyGetResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyListParams 

type AccessPolicyListParams struct {
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// The ID of the team.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (AccessPolicyListParams) URLQuery 

func (r AccessPolicyListParams) URLQuery() (v url.Values, err error)

URLQuery serializes AccessPolicyListParams's query parameters as `url.Values`.

type AccessPolicyListResponse added in v0.6.0 

type AccessPolicyListResponse struct {
	// The list of access policies.
	Data []AccessPolicy `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyListResponse) RawJSON added in v0.6.0 

func (r AccessPolicyListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyListResponse) UnmarshalJSON added in v0.6.0 

func (r *AccessPolicyListResponse) UnmarshalJSON(data []byte) error

type AccessPolicyNewParams 

type AccessPolicyNewParams struct {
	// The name of the access policy.
	Name string `json:"name,required"`
	// The ID of the team.
	TeamID string `json:"teamId,required"`
	// The maximum number of minutes that access can be granted for (optional).
	MaxAccessMinutes param.Opt[int64] `json:"maxAccessMinutes,omitzero"`
	// The recommended duration in minutes for access requests (optional).
	RecommendedAccessMinutes param.Opt[int64] `json:"recommendedAccessMinutes,omitzero"`
	// Whether a business justification is required when requesting access (optional).
	RequireBusinessJustification param.Opt[bool] `json:"requireBusinessJustification,omitzero"`
	// A description of the access policy.
	Description param.Opt[string] `json:"description,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyNewParams) MarshalJSON 

func (r AccessPolicyNewParams) MarshalJSON() (data []byte, err error)

func (*AccessPolicyNewParams) UnmarshalJSON 

func (r *AccessPolicyNewParams) UnmarshalJSON(data []byte) error

type AccessPolicyNewResponseEnvelope 

type AccessPolicyNewResponseEnvelope struct {
	// The created access policy.
	Data AccessPolicy `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyNewResponseEnvelope) RawJSON 

func (r AccessPolicyNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyNewResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyNewResponseEnvelope) UnmarshalJSON(data []byte) error

type AccessPolicyService 

type AccessPolicyService struct {
	Options            []option.RequestOption
	ApprovalProcedures AccessPolicyApprovalProcedureService
}

AccessPolicyService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAccessPolicyService method instead.

func NewAccessPolicyService 

func NewAccessPolicyService(opts ...option.RequestOption) (r AccessPolicyService)

NewAccessPolicyService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*AccessPolicyService) Delete 

func (r *AccessPolicyService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *AccessPolicyDeleteResponse, err error)

Delete an access policy.

func (*AccessPolicyService) Get 

func (r *AccessPolicyService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *AccessPolicy, err error)

Get a specific access policy by ID.

func (*AccessPolicyService) List 

func (r *AccessPolicyService) List(ctx context.Context, query AccessPolicyListParams, opts ...option.RequestOption) (res *AccessPolicyListResponse, err error)

List all access policies for a team.

func (*AccessPolicyService) New 

func (r *AccessPolicyService) New(ctx context.Context, body AccessPolicyNewParams, opts ...option.RequestOption) (res *AccessPolicy, err error)

Create a new access policy for a team.

func (*AccessPolicyService) Update 

func (r *AccessPolicyService) Update(ctx context.Context, id string, body AccessPolicyUpdateParams, opts ...option.RequestOption) (res *AccessPolicy, err error)

Update an existing access policy.

type AccessPolicyUpdateParams 

type AccessPolicyUpdateParams struct {
	// The recommended duration in minutes for access requests (optional).
	RecommendedAccessMinutes param.Opt[int64] `json:"recommendedAccessMinutes,omitzero"`
	// A description of the access policy.
	Description param.Opt[string] `json:"description,omitzero"`
	// The maximum number of minutes that access can be granted for.
	MaxAccessMinutes param.Opt[int64] `json:"maxAccessMinutes,omitzero"`
	// The name of the access policy.
	Name param.Opt[string] `json:"name,omitzero"`
	// Whether a business justification is required when requesting access.
	RequireBusinessJustification param.Opt[bool] `json:"requireBusinessJustification,omitzero"`
	// contains filtered or unexported fields
}

func (AccessPolicyUpdateParams) MarshalJSON 

func (r AccessPolicyUpdateParams) MarshalJSON() (data []byte, err error)

func (*AccessPolicyUpdateParams) UnmarshalJSON 

func (r *AccessPolicyUpdateParams) UnmarshalJSON(data []byte) error

type AccessPolicyUpdateResponseEnvelope 

type AccessPolicyUpdateResponseEnvelope struct {
	// The updated access policy.
	Data AccessPolicy `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AccessPolicyUpdateResponseEnvelope) RawJSON 

func (r AccessPolicyUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AccessPolicyUpdateResponseEnvelope) UnmarshalJSON 

func (r *AccessPolicyUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type AppInstance 

type AppInstance struct {
	// The ID of the app instance.
	ID string `json:"id"`
	// Whether access requests are enabled for the app instance.
	AccessRequestsEnabled bool `json:"accessRequestsEnabled"`
	// **Option: custom_service_id** — The ID of the custom service (for custom apps).
	CustomServiceID string `json:"customServiceId"`
	// The default access policy for the app instance.
	DefaultAccessPolicyID string `json:"defaultAccessPolicyId,nullable"`
	// The instance ID of the app instance.
	InstanceID string `json:"instanceId"`
	// The name of the app instance.
	Name string `json:"name"`
	// **Option: service** — The service identifier (for built-in services like
	// "github", "okta", "aws").
	Service string `json:"service"`
	// The ID of the Serval team that the app instance belongs to.
	TeamID string `json:"teamId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                    respjson.Field
		AccessRequestsEnabled respjson.Field
		CustomServiceID       respjson.Field
		DefaultAccessPolicyID respjson.Field
		InstanceID            respjson.Field
		Name                  respjson.Field
		Service               respjson.Field
		TeamID                respjson.Field
		ExtraFields           map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

Configuration object.

**Set exactly ONE of:** customServiceId, service

func (AppInstance) RawJSON 

func (r AppInstance) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppInstance) UnmarshalJSON 

func (r *AppInstance) UnmarshalJSON(data []byte) error

type AppInstanceDeleteResponse 

type AppInstanceDeleteResponse = any

type AppInstanceGetResponseEnvelope 

type AppInstanceGetResponseEnvelope struct {
	// The app instance.
	Data AppInstance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppInstanceGetResponseEnvelope) RawJSON 

func (r AppInstanceGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppInstanceGetResponseEnvelope) UnmarshalJSON 

func (r *AppInstanceGetResponseEnvelope) UnmarshalJSON(data []byte) error

type AppInstanceListParams 

type AppInstanceListParams struct {
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// The ID of the team.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (AppInstanceListParams) URLQuery 

func (r AppInstanceListParams) URLQuery() (v url.Values, err error)

URLQuery serializes AppInstanceListParams's query parameters as `url.Values`.

type AppInstanceListResponse added in v0.6.0 

type AppInstanceListResponse struct {
	// The list of app instances.
	Data []AppInstance `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppInstanceListResponse) RawJSON added in v0.6.0 

func (r AppInstanceListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppInstanceListResponse) UnmarshalJSON added in v0.6.0 

func (r *AppInstanceListResponse) UnmarshalJSON(data []byte) error

type AppInstanceNewParams 

type AppInstanceNewParams struct {
	// The instance ID of the app instance.
	InstanceID string `json:"instanceId,required"`
	// The name of the app instance.
	Name string `json:"name,required"`
	// The ID of the team.
	TeamID string `json:"teamId,required"`
	// The default access policy for the app instance (optional).
	DefaultAccessPolicyID param.Opt[string] `json:"defaultAccessPolicyId,omitzero"`
	// Whether access requests are enabled for the app instance.
	AccessRequestsEnabled param.Opt[bool] `json:"accessRequestsEnabled,omitzero"`
	// **Option: custom_service_id** — The ID of a custom service to create the app
	// instance for.
	CustomServiceID param.Opt[string] `json:"customServiceId,omitzero"`
	// **Option: service** — The service identifier (for built-in services like
	// "github", "okta", "aws").
	Service param.Opt[string] `json:"service,omitzero"`
	// contains filtered or unexported fields
}

func (AppInstanceNewParams) MarshalJSON 

func (r AppInstanceNewParams) MarshalJSON() (data []byte, err error)

func (*AppInstanceNewParams) UnmarshalJSON 

func (r *AppInstanceNewParams) UnmarshalJSON(data []byte) error

type AppInstanceNewResponseEnvelope 

type AppInstanceNewResponseEnvelope struct {
	// The created app instance.
	Data AppInstance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppInstanceNewResponseEnvelope) RawJSON 

func (r AppInstanceNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppInstanceNewResponseEnvelope) UnmarshalJSON 

func (r *AppInstanceNewResponseEnvelope) UnmarshalJSON(data []byte) error

type AppInstanceService 

type AppInstanceService struct {
	Options []option.RequestOption
}

AppInstanceService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAppInstanceService method instead.

func NewAppInstanceService 

func NewAppInstanceService(opts ...option.RequestOption) (r AppInstanceService)

NewAppInstanceService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*AppInstanceService) Delete 

func (r *AppInstanceService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *AppInstanceDeleteResponse, err error)

Delete an app instance.

func (*AppInstanceService) Get 

func (r *AppInstanceService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *AppInstance, err error)

Get a specific app instance by ID.

func (*AppInstanceService) List 

func (r *AppInstanceService) List(ctx context.Context, query AppInstanceListParams, opts ...option.RequestOption) (res *AppInstanceListResponse, err error)

List all app instances for a team.

func (*AppInstanceService) New 

func (r *AppInstanceService) New(ctx context.Context, body AppInstanceNewParams, opts ...option.RequestOption) (res *AppInstance, err error)

Create a new app instance for a team.

func (*AppInstanceService) Update 

func (r *AppInstanceService) Update(ctx context.Context, id string, body AppInstanceUpdateParams, opts ...option.RequestOption) (res *AppInstance, err error)

Update an existing app instance.

type AppInstanceUpdateParams 

type AppInstanceUpdateParams struct {
	// The default access policy for the app instance (optional).
	DefaultAccessPolicyID param.Opt[string] `json:"defaultAccessPolicyId,omitzero"`
	// Whether access requests are enabled for the app instance.
	AccessRequestsEnabled param.Opt[bool] `json:"accessRequestsEnabled,omitzero"`
	// The instance ID of the app instance.
	InstanceID param.Opt[string] `json:"instanceId,omitzero"`
	// The name of the app instance.
	Name param.Opt[string] `json:"name,omitzero"`
	// contains filtered or unexported fields
}

func (AppInstanceUpdateParams) MarshalJSON 

func (r AppInstanceUpdateParams) MarshalJSON() (data []byte, err error)

func (*AppInstanceUpdateParams) UnmarshalJSON 

func (r *AppInstanceUpdateParams) UnmarshalJSON(data []byte) error

type AppInstanceUpdateResponseEnvelope 

type AppInstanceUpdateResponseEnvelope struct {
	// The updated app instance.
	Data AppInstance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppInstanceUpdateResponseEnvelope) RawJSON 

func (r AppInstanceUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppInstanceUpdateResponseEnvelope) UnmarshalJSON 

func (r *AppInstanceUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResource 

type AppResource struct {
	// The ID of the resource.
	ID string `json:"id"`
	// The ID of the app instance that the resource belongs to.
	AppInstanceID string `json:"appInstanceId"`
	// A description of the resource.
	Description string `json:"description"`
	// The external ID of the resource.
	ExternalID string `json:"externalId,nullable"`
	// The name of the resource.
	Name string `json:"name"`
	// The type of the resource.
	ResourceType string `json:"resourceType"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID            respjson.Field
		AppInstanceID respjson.Field
		Description   respjson.Field
		ExternalID    respjson.Field
		Name          respjson.Field
		ResourceType  respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResource) RawJSON 

func (r AppResource) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResource) UnmarshalJSON 

func (r *AppResource) UnmarshalJSON(data []byte) error

type AppResourceDeleteResponse 

type AppResourceDeleteResponse = any

type AppResourceGetResponseEnvelope 

type AppResourceGetResponseEnvelope struct {
	// The resource.
	Data AppResource `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceGetResponseEnvelope) RawJSON 

func (r AppResourceGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceGetResponseEnvelope) UnmarshalJSON 

func (r *AppResourceGetResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResourceListParams 

type AppResourceListParams struct {
	// Filter by app instance ID. At least one of team_id or app_instance_id must be
	// provided.
	AppInstanceID param.Opt[string] `query:"appInstanceId,omitzero" json:"-"`
	// Maximum number of results to return. Default is 5000, maximum is 5000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// Filter by team ID. At least one of team_id or app_instance_id must be provided.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (AppResourceListParams) URLQuery 

func (r AppResourceListParams) URLQuery() (v url.Values, err error)

URLQuery serializes AppResourceListParams's query parameters as `url.Values`.

type AppResourceListResponse added in v0.6.0 

type AppResourceListResponse struct {
	// The list of resources.
	Data []AppResource `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceListResponse) RawJSON added in v0.6.0 

func (r AppResourceListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceListResponse) UnmarshalJSON added in v0.6.0 

func (r *AppResourceListResponse) UnmarshalJSON(data []byte) error

type AppResourceNewParams 

type AppResourceNewParams struct {
	// The ID of the app instance.
	AppInstanceID string `json:"appInstanceId,required"`
	// The name of the resource.
	Name string `json:"name,required"`
	// The type of the resource.
	ResourceType string `json:"resourceType,required"`
	// The external ID of the resource (optional).
	ExternalID param.Opt[string] `json:"externalId,omitzero"`
	// A description of the resource.
	Description param.Opt[string] `json:"description,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceNewParams) MarshalJSON 

func (r AppResourceNewParams) MarshalJSON() (data []byte, err error)

func (*AppResourceNewParams) UnmarshalJSON 

func (r *AppResourceNewParams) UnmarshalJSON(data []byte) error

type AppResourceNewResponseEnvelope 

type AppResourceNewResponseEnvelope struct {
	// The created resource.
	Data AppResource `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceNewResponseEnvelope) RawJSON 

func (r AppResourceNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceNewResponseEnvelope) UnmarshalJSON 

func (r *AppResourceNewResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResourceRole added in v0.7.0 

type AppResourceRole struct {
	// The ID of the role.
	ID string `json:"id"`
	// The default access policy for the role.
	AccessPolicyID string `json:"accessPolicyId,nullable"`
	// A description of the role.
	Description string `json:"description"`
	// Data from the external system as a JSON string (computed by server).
	ExternalData string `json:"externalData,nullable"`
	// The external ID of the role in the external system (optional).
	ExternalID string `json:"externalId,nullable"`
	// The name of the role.
	Name string `json:"name"`
	// Provisioning configuration. **Exactly one method should be set.**
	ProvisioningMethod AppResourceRoleProvisioningMethodUnion `json:"provisioningMethod"`
	// Whether requests are enabled for the role.
	RequestsEnabled bool `json:"requestsEnabled"`
	// The ID of the resource that the role belongs to.
	ResourceID string `json:"resourceId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                 respjson.Field
		AccessPolicyID     respjson.Field
		Description        respjson.Field
		ExternalData       respjson.Field
		ExternalID         respjson.Field
		Name               respjson.Field
		ProvisioningMethod respjson.Field
		RequestsEnabled    respjson.Field
		ResourceID         respjson.Field
		ExtraFields        map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

Role represents a requestable role on an app resource.

func (AppResourceRole) RawJSON added in v0.7.0 

func (r AppResourceRole) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRole) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRole) UnmarshalJSON(data []byte) error

type AppResourceRoleDeleteResponse added in v0.7.0 

type AppResourceRoleDeleteResponse = any

type AppResourceRoleGetResponseEnvelope added in v0.7.0 

type AppResourceRoleGetResponseEnvelope struct {
	// The role.
	Data AppResourceRole `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleGetResponseEnvelope) RawJSON added in v0.7.0 

func (r AppResourceRoleGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleGetResponseEnvelope) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleGetResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResourceRoleListParams added in v0.7.0 

type AppResourceRoleListParams struct {
	// Filter by app instance ID. At least one of team_id, app_instance_id, or
	// resource_id must be provided.
	AppInstanceID param.Opt[string] `query:"appInstanceId,omitzero" json:"-"`
	// Maximum number of results to return. Default is 5000, maximum is 5000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// Filter by resource ID. At least one of team_id, app_instance_id, or resource_id
	// must be provided.
	ResourceID param.Opt[string] `query:"resourceId,omitzero" json:"-"`
	// Filter by team ID. At least one of team_id, app_instance_id, or resource_id must
	// be provided.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (AppResourceRoleListParams) URLQuery added in v0.7.0 

func (r AppResourceRoleListParams) URLQuery() (v url.Values, err error)

URLQuery serializes AppResourceRoleListParams's query parameters as `url.Values`.

type AppResourceRoleListResponse added in v0.7.0 

type AppResourceRoleListResponse struct {
	// The list of roles.
	Data []AppResourceRole `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleListResponse) RawJSON added in v0.7.0 

func (r AppResourceRoleListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleListResponse) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleListResponse) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParams added in v0.7.0 

type AppResourceRoleNewParams struct {
	// The name of the role.
	Name string `json:"name,required"`
	// Provisioning configuration. Exactly one method should be set.
	ProvisioningMethod AppResourceRoleNewParamsProvisioningMethodUnion `json:"provisioningMethod,omitzero,required"`
	// The ID of the resource.
	ResourceID string `json:"resourceId,required"`
	// The default access policy for the role (optional).
	AccessPolicyID param.Opt[string] `json:"accessPolicyId,omitzero"`
	// Data from the external system as a JSON string (optional).
	ExternalData param.Opt[string] `json:"externalData,omitzero"`
	// The external ID of the role in the external system (optional).
	ExternalID param.Opt[string] `json:"externalId,omitzero"`
	// A description of the role.
	Description param.Opt[string] `json:"description,omitzero"`
	// Whether requests are enabled for the role.
	RequestsEnabled param.Opt[bool] `json:"requestsEnabled,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceRoleNewParams) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParams) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParams) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParams) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow struct {
	// Provisioning is handled by the service's builtin workflow integration.
	BuiltinWorkflow any `json:"builtinWorkflow,omitzero,required"`
	// contains filtered or unexported fields
}

The property BuiltinWorkflow is required.

func (AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodCustomWorkflow added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodCustomWorkflow struct {
	// Provisioning is handled by custom workflows for provision + deprovision.
	CustomWorkflow AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow `json:"customWorkflow,omitzero,required"`
	// contains filtered or unexported fields
}

The property CustomWorkflow is required.

func (AppResourceRoleNewParamsProvisioningMethodCustomWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodCustomWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow struct {
	// The workflow ID to deprovision access.
	DeprovisionWorkflowID param.Opt[string] `json:"deprovisionWorkflowId,omitzero"`
	// The workflow ID to provision access.
	ProvisionWorkflowID param.Opt[string] `json:"provisionWorkflowId,omitzero"`
	// contains filtered or unexported fields
}

Provisioning is handled by custom workflows for provision + deprovision.

func (AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodLinkedRoles added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodLinkedRoles struct {
	// Provisioning depends on prerequisite roles being provisioned first.
	LinkedRoles AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles `json:"linkedRoles,omitzero,required"`
	// contains filtered or unexported fields
}

The property LinkedRoles is required.

func (AppResourceRoleNewParamsProvisioningMethodLinkedRoles) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodLinkedRoles) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles struct {
	// The IDs of prerequisite roles.
	LinkedRoleIDs []string `json:"linkedRoleIds,omitzero"`
	// contains filtered or unexported fields
}

Provisioning depends on prerequisite roles being provisioned first.

func (AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodManual added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodManual struct {
	// Provisioning is handled manually by assigned users/groups.
	Manual AppResourceRoleNewParamsProvisioningMethodManualManual `json:"manual,omitzero,required"`
	// contains filtered or unexported fields
}

The property Manual is required.

func (AppResourceRoleNewParamsProvisioningMethodManual) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodManual) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodManual) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodManualManual added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodManualManual struct {
	// Users and groups that should be assigned/notified for manual provisioning.
	Assignees []AppResourceRoleNewParamsProvisioningMethodManualManualAssignee `json:"assignees,omitzero"`
	// contains filtered or unexported fields
}

Provisioning is handled manually by assigned users/groups.

func (AppResourceRoleNewParamsProvisioningMethodManualManual) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodManualManual) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodManualManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodManualManual) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodManualManualAssignee added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodManualManualAssignee struct {
	// The ID of the user or group.
	AssigneeID param.Opt[string] `json:"assigneeId,omitzero"`
	// The type of assignee.
	//
	// Any of "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP".
	AssigneeType string `json:"assigneeType,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceRoleNewParamsProvisioningMethodManualManualAssignee) MarshalJSON added in v0.7.0 

func (r AppResourceRoleNewParamsProvisioningMethodManualManualAssignee) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleNewParamsProvisioningMethodManualManualAssignee) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewParamsProvisioningMethodManualManualAssignee) UnmarshalJSON(data []byte) error

type AppResourceRoleNewParamsProvisioningMethodUnion added in v0.7.0 

type AppResourceRoleNewParamsProvisioningMethodUnion struct {
	OfBuiltinWorkflow *AppResourceRoleNewParamsProvisioningMethodBuiltinWorkflow `json:",omitzero,inline"`
	OfCustomWorkflow  *AppResourceRoleNewParamsProvisioningMethodCustomWorkflow  `json:",omitzero,inline"`
	OfLinkedRoles     *AppResourceRoleNewParamsProvisioningMethodLinkedRoles     `json:",omitzero,inline"`
	OfManual          *AppResourceRoleNewParamsProvisioningMethodManual          `json:",omitzero,inline"`
	// contains filtered or unexported fields
}

Only one field can be non-zero.

Use param.IsOmitted to confirm if a field is set.

func (AppResourceRoleNewParamsProvisioningMethodUnion) MarshalJSON added in v0.7.0 

func (u AppResourceRoleNewParamsProvisioningMethodUnion) MarshalJSON() ([]byte, error)

func (*AppResourceRoleNewParamsProvisioningMethodUnion) UnmarshalJSON added in v0.7.0 

func (u *AppResourceRoleNewParamsProvisioningMethodUnion) UnmarshalJSON(data []byte) error

type AppResourceRoleNewResponseEnvelope added in v0.7.0 

type AppResourceRoleNewResponseEnvelope struct {
	// The created role.
	Data AppResourceRole `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleNewResponseEnvelope) RawJSON added in v0.7.0 

func (r AppResourceRoleNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleNewResponseEnvelope) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleNewResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodBuiltinWorkflow added in v0.7.0 

type AppResourceRoleProvisioningMethodBuiltinWorkflow struct {
	// Provisioning is handled by the service's builtin workflow integration.
	BuiltinWorkflow any `json:"builtinWorkflow,required"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		BuiltinWorkflow respjson.Field
		ExtraFields     map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleProvisioningMethodBuiltinWorkflow) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodBuiltinWorkflow) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodBuiltinWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodBuiltinWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodCustomWorkflow added in v0.7.0 

type AppResourceRoleProvisioningMethodCustomWorkflow struct {
	// Provisioning is handled by custom workflows for provision + deprovision.
	CustomWorkflow AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow `json:"customWorkflow,required"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		CustomWorkflow respjson.Field
		ExtraFields    map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleProvisioningMethodCustomWorkflow) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodCustomWorkflow) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow added in v0.7.0 

type AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow struct {
	// The workflow ID to deprovision access.
	DeprovisionWorkflowID string `json:"deprovisionWorkflowId"`
	// The workflow ID to provision access.
	ProvisionWorkflowID string `json:"provisionWorkflowId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		DeprovisionWorkflowID respjson.Field
		ProvisionWorkflowID   respjson.Field
		ExtraFields           map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

Provisioning is handled by custom workflows for provision + deprovision.

func (AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodLinkedRoles added in v0.7.0 

type AppResourceRoleProvisioningMethodLinkedRoles struct {
	// Provisioning depends on prerequisite roles being provisioned first.
	LinkedRoles AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles `json:"linkedRoles,required"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		LinkedRoles respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleProvisioningMethodLinkedRoles) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodLinkedRoles) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles added in v0.7.0 

type AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles struct {
	// The IDs of prerequisite roles.
	LinkedRoleIDs []string `json:"linkedRoleIds"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		LinkedRoleIDs respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

Provisioning depends on prerequisite roles being provisioned first.

func (AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodManual added in v0.7.0 

type AppResourceRoleProvisioningMethodManual struct {
	// Provisioning is handled manually by assigned users/groups.
	Manual AppResourceRoleProvisioningMethodManualManual `json:"manual,required"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Manual      respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleProvisioningMethodManual) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodManual) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodManual) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodManualManual added in v0.7.0 

type AppResourceRoleProvisioningMethodManualManual struct {
	// Users and groups that should be assigned/notified for manual provisioning.
	Assignees []AppResourceRoleProvisioningMethodManualManualAssignee `json:"assignees"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Assignees   respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

Provisioning is handled manually by assigned users/groups.

func (AppResourceRoleProvisioningMethodManualManual) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodManualManual) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodManualManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodManualManual) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodManualManualAssignee added in v0.7.0 

type AppResourceRoleProvisioningMethodManualManualAssignee struct {
	// The ID of the user or group.
	AssigneeID string `json:"assigneeId"`
	// The type of assignee.
	//
	// Any of "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP".
	AssigneeType string `json:"assigneeType"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		AssigneeID   respjson.Field
		AssigneeType respjson.Field
		ExtraFields  map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleProvisioningMethodManualManualAssignee) RawJSON added in v0.7.0 

func (r AppResourceRoleProvisioningMethodManualManualAssignee) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodManualManualAssignee) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodManualManualAssignee) UnmarshalJSON(data []byte) error

type AppResourceRoleProvisioningMethodUnion added in v0.7.0 

type AppResourceRoleProvisioningMethodUnion struct {
	// This field is from variant [AppResourceRoleProvisioningMethodBuiltinWorkflow].
	BuiltinWorkflow any `json:"builtinWorkflow"`
	// This field is from variant [AppResourceRoleProvisioningMethodCustomWorkflow].
	CustomWorkflow AppResourceRoleProvisioningMethodCustomWorkflowCustomWorkflow `json:"customWorkflow"`
	// This field is from variant [AppResourceRoleProvisioningMethodLinkedRoles].
	LinkedRoles AppResourceRoleProvisioningMethodLinkedRolesLinkedRoles `json:"linkedRoles"`
	// This field is from variant [AppResourceRoleProvisioningMethodManual].
	Manual AppResourceRoleProvisioningMethodManualManual `json:"manual"`
	JSON   struct {
		BuiltinWorkflow respjson.Field
		CustomWorkflow  respjson.Field
		LinkedRoles     respjson.Field
		Manual          respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

AppResourceRoleProvisioningMethodUnion contains all possible properties and values from AppResourceRoleProvisioningMethodBuiltinWorkflow, AppResourceRoleProvisioningMethodCustomWorkflow, AppResourceRoleProvisioningMethodLinkedRoles, AppResourceRoleProvisioningMethodManual.

Use the methods beginning with 'As' to cast the union to one of its variants.

func (AppResourceRoleProvisioningMethodUnion) AsBuiltinWorkflow added in v0.7.0 

func (u AppResourceRoleProvisioningMethodUnion) AsBuiltinWorkflow() (v AppResourceRoleProvisioningMethodBuiltinWorkflow)

func (AppResourceRoleProvisioningMethodUnion) AsCustomWorkflow added in v0.7.0 

func (u AppResourceRoleProvisioningMethodUnion) AsCustomWorkflow() (v AppResourceRoleProvisioningMethodCustomWorkflow)

func (AppResourceRoleProvisioningMethodUnion) AsLinkedRoles added in v0.7.0 

func (u AppResourceRoleProvisioningMethodUnion) AsLinkedRoles() (v AppResourceRoleProvisioningMethodLinkedRoles)

func (AppResourceRoleProvisioningMethodUnion) AsManual added in v0.7.0 

func (u AppResourceRoleProvisioningMethodUnion) AsManual() (v AppResourceRoleProvisioningMethodManual)

func (AppResourceRoleProvisioningMethodUnion) RawJSON added in v0.7.0 

func (u AppResourceRoleProvisioningMethodUnion) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleProvisioningMethodUnion) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleProvisioningMethodUnion) UnmarshalJSON(data []byte) error

type AppResourceRoleService added in v0.7.0 

type AppResourceRoleService struct {
	Options []option.RequestOption
}

AppResourceRoleService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAppResourceRoleService method instead.

func NewAppResourceRoleService added in v0.7.0 

func NewAppResourceRoleService(opts ...option.RequestOption) (r AppResourceRoleService)

NewAppResourceRoleService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*AppResourceRoleService) Delete added in v0.7.0 

func (r *AppResourceRoleService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *AppResourceRoleDeleteResponse, err error)

Delete an app resource role.

func (*AppResourceRoleService) Get added in v0.7.0 

func (r *AppResourceRoleService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *AppResourceRole, err error)

Get a specific app resource role by ID.

func (*AppResourceRoleService) List added in v0.7.0 

func (r *AppResourceRoleService) List(ctx context.Context, query AppResourceRoleListParams, opts ...option.RequestOption) (res *AppResourceRoleListResponse, err error)

List all app resource roles for a team, optionally filtered by resource.

func (*AppResourceRoleService) New added in v0.7.0 

func (r *AppResourceRoleService) New(ctx context.Context, body AppResourceRoleNewParams, opts ...option.RequestOption) (res *AppResourceRole, err error)

Create a new app resource role for a resource.

func (*AppResourceRoleService) Update added in v0.7.0 

func (r *AppResourceRoleService) Update(ctx context.Context, id string, body AppResourceRoleUpdateParams, opts ...option.RequestOption) (res *AppResourceRole, err error)

Update an existing app resource role.

type AppResourceRoleUpdateParams added in v0.7.0 

type AppResourceRoleUpdateParams struct {
	// The default access policy for the role (optional).
	AccessPolicyID param.Opt[string] `json:"accessPolicyId,omitzero"`
	// Data from the external system as a JSON string (optional).
	ExternalData param.Opt[string] `json:"externalData,omitzero"`
	// The external ID of the role in the external system (optional).
	ExternalID param.Opt[string] `json:"externalId,omitzero"`
	// A description of the role.
	Description param.Opt[string] `json:"description,omitzero"`
	// The name of the role.
	Name param.Opt[string] `json:"name,omitzero"`
	// Whether requests are enabled for the role.
	RequestsEnabled param.Opt[bool] `json:"requestsEnabled,omitzero"`
	// Provisioning configuration. Exactly one method should be set.
	ProvisioningMethod AppResourceRoleUpdateParamsProvisioningMethodUnion `json:"provisioningMethod,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceRoleUpdateParams) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParams) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParams) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParams) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow struct {
	// Provisioning is handled by the service's builtin workflow integration.
	BuiltinWorkflow any `json:"builtinWorkflow,omitzero,required"`
	// contains filtered or unexported fields
}

The property BuiltinWorkflow is required.

func (AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow struct {
	// Provisioning is handled by custom workflows for provision + deprovision.
	CustomWorkflow AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow `json:"customWorkflow,omitzero,required"`
	// contains filtered or unexported fields
}

The property CustomWorkflow is required.

func (AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow struct {
	// The workflow ID to deprovision access.
	DeprovisionWorkflowID param.Opt[string] `json:"deprovisionWorkflowId,omitzero"`
	// The workflow ID to provision access.
	ProvisionWorkflowID param.Opt[string] `json:"provisionWorkflowId,omitzero"`
	// contains filtered or unexported fields
}

Provisioning is handled by custom workflows for provision + deprovision.

func (AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflowCustomWorkflow) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles struct {
	// Provisioning depends on prerequisite roles being provisioned first.
	LinkedRoles AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles `json:"linkedRoles,omitzero,required"`
	// contains filtered or unexported fields
}

The property LinkedRoles is required.

func (AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles struct {
	// The IDs of prerequisite roles.
	LinkedRoleIDs []string `json:"linkedRoleIds,omitzero"`
	// contains filtered or unexported fields
}

Provisioning depends on prerequisite roles being provisioned first.

func (AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodLinkedRolesLinkedRoles) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodManual added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodManual struct {
	// Provisioning is handled manually by assigned users/groups.
	Manual AppResourceRoleUpdateParamsProvisioningMethodManualManual `json:"manual,omitzero,required"`
	// contains filtered or unexported fields
}

The property Manual is required.

func (AppResourceRoleUpdateParamsProvisioningMethodManual) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodManual) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodManual) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodManualManual added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodManualManual struct {
	// Users and groups that should be assigned/notified for manual provisioning.
	Assignees []AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee `json:"assignees,omitzero"`
	// contains filtered or unexported fields
}

Provisioning is handled manually by assigned users/groups.

func (AppResourceRoleUpdateParamsProvisioningMethodManualManual) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodManualManual) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodManualManual) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodManualManual) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee struct {
	// The ID of the user or group.
	AssigneeID param.Opt[string] `json:"assigneeId,omitzero"`
	// The type of assignee.
	//
	// Any of "MANUAL_PROVISIONING_ASSIGNEE_TYPE_UNSPECIFIED",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_USER",
	// "MANUAL_PROVISIONING_ASSIGNEE_TYPE_GROUP".
	AssigneeType string `json:"assigneeType,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee) MarshalJSON added in v0.7.0 

func (r AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee) MarshalJSON() (data []byte, err error)

func (*AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateParamsProvisioningMethodManualManualAssignee) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateParamsProvisioningMethodUnion added in v0.7.0 

type AppResourceRoleUpdateParamsProvisioningMethodUnion struct {
	OfBuiltinWorkflow *AppResourceRoleUpdateParamsProvisioningMethodBuiltinWorkflow `json:",omitzero,inline"`
	OfCustomWorkflow  *AppResourceRoleUpdateParamsProvisioningMethodCustomWorkflow  `json:",omitzero,inline"`
	OfLinkedRoles     *AppResourceRoleUpdateParamsProvisioningMethodLinkedRoles     `json:",omitzero,inline"`
	OfManual          *AppResourceRoleUpdateParamsProvisioningMethodManual          `json:",omitzero,inline"`
	// contains filtered or unexported fields
}

Only one field can be non-zero.

Use param.IsOmitted to confirm if a field is set.

func (AppResourceRoleUpdateParamsProvisioningMethodUnion) MarshalJSON added in v0.7.0 

func (u AppResourceRoleUpdateParamsProvisioningMethodUnion) MarshalJSON() ([]byte, error)

func (*AppResourceRoleUpdateParamsProvisioningMethodUnion) UnmarshalJSON added in v0.7.0 

func (u *AppResourceRoleUpdateParamsProvisioningMethodUnion) UnmarshalJSON(data []byte) error

type AppResourceRoleUpdateResponseEnvelope added in v0.7.0 

type AppResourceRoleUpdateResponseEnvelope struct {
	// The updated role.
	Data AppResourceRole `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceRoleUpdateResponseEnvelope) RawJSON added in v0.7.0 

func (r AppResourceRoleUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceRoleUpdateResponseEnvelope) UnmarshalJSON added in v0.7.0 

func (r *AppResourceRoleUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type AppResourceService 

type AppResourceService struct {
	Options []option.RequestOption
}

AppResourceService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewAppResourceService method instead.

func NewAppResourceService 

func NewAppResourceService(opts ...option.RequestOption) (r AppResourceService)

NewAppResourceService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*AppResourceService) Delete 

func (r *AppResourceService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *AppResourceDeleteResponse, err error)

Delete an app resource.

func (*AppResourceService) Get 

func (r *AppResourceService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *AppResource, err error)

Get a specific app resource by ID.

func (*AppResourceService) List 

func (r *AppResourceService) List(ctx context.Context, query AppResourceListParams, opts ...option.RequestOption) (res *AppResourceListResponse, err error)

List all app resources for a team, optionally filtered by app instance.

func (*AppResourceService) New 

func (r *AppResourceService) New(ctx context.Context, body AppResourceNewParams, opts ...option.RequestOption) (res *AppResource, err error)

Create a new app resource for an app instance.

func (*AppResourceService) Update 

func (r *AppResourceService) Update(ctx context.Context, id string, body AppResourceUpdateParams, opts ...option.RequestOption) (res *AppResource, err error)

Update an existing app resource.

type AppResourceUpdateParams 

type AppResourceUpdateParams struct {
	// The external ID of the resource (optional).
	ExternalID param.Opt[string] `json:"externalId,omitzero"`
	// A description of the resource.
	Description param.Opt[string] `json:"description,omitzero"`
	// The name of the resource.
	Name param.Opt[string] `json:"name,omitzero"`
	// The type of the resource.
	ResourceType param.Opt[string] `json:"resourceType,omitzero"`
	// contains filtered or unexported fields
}

func (AppResourceUpdateParams) MarshalJSON 

func (r AppResourceUpdateParams) MarshalJSON() (data []byte, err error)

func (*AppResourceUpdateParams) UnmarshalJSON 

func (r *AppResourceUpdateParams) UnmarshalJSON(data []byte) error

type AppResourceUpdateResponseEnvelope 

type AppResourceUpdateResponseEnvelope struct {
	// The updated resource.
	Data AppResource `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (AppResourceUpdateResponseEnvelope) RawJSON 

func (r AppResourceUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*AppResourceUpdateResponseEnvelope) UnmarshalJSON 

func (r *AppResourceUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type Client 

type Client struct {
	Options          []option.RequestOption
	AccessPolicies   AccessPolicyService
	Guidances        GuidanceService
	Workflows        WorkflowService
	AppInstances     AppInstanceService
	AppResources     AppResourceService
	AppResourceRoles AppResourceRoleService
	Users            UserService
	Groups           GroupService
	Teams            TeamService
	CustomServices   CustomServiceService
}

Client creates a struct with services and top level methods that help with interacting with the serval API. You should not instantiate this client directly, and instead use the NewClient method instead.

func NewClient 

func NewClient(opts ...option.RequestOption) (r Client)

NewClient generates a new client with the default option read from the environment (SERVAL_CLIENT_ID, SERVAL_CLIENT_SECRET, SERVAL_BASE_URL). The option passed in as arguments are applied after these default arguments, and all option will be passed down to the services and requests that this client makes.

func (*Client) Delete 

func (r *Client) Delete(ctx context.Context, path string, params any, res any, opts ...option.RequestOption) error

Delete makes a DELETE request with the given URL, params, and optionally deserializes to a response. See [Execute] documentation on the params and response.

func (*Client) Execute 

func (r *Client) Execute(ctx context.Context, method string, path string, params any, res any, opts ...option.RequestOption) error

Execute makes a request with the given context, method, URL, request params, response, and request options. This is useful for hitting undocumented endpoints while retaining the base URL, auth, retries, and other options from the client.

If a byte slice or an io.Reader is supplied to params, it will be used as-is for the request body.

The params is by default serialized into the body using encoding/json. If your type implements a MarshalJSON function, it will be used instead to serialize the request. If a URLQuery method is implemented, the returned url.Values will be used as query strings to the url.

If your params struct uses param.Field, you must provide either [MarshalJSON], [URLQuery], and/or [MarshalForm] functions. It is undefined behavior to use a struct uses param.Field without specifying how it is serialized.

Any "…Params" object defined in this library can be used as the request argument. Note that 'path' arguments will not be forwarded into the url.

The response body will be deserialized into the res variable, depending on its type:

  • A pointer to a *http.Response is populated by the raw response.
  • A pointer to a byte array will be populated with the contents of the request body.
  • A pointer to any other type uses this library's default JSON decoding, which respects UnmarshalJSON if it is defined on the type.
  • A nil value will not read the response body.

For even greater flexibility, see option.WithResponseInto and option.WithResponseBodyInto.

func (*Client) Get 

func (r *Client) Get(ctx context.Context, path string, params any, res any, opts ...option.RequestOption) error

Get makes a GET request with the given URL, params, and optionally deserializes to a response. See [Execute] documentation on the params and response.

func (*Client) Patch 

func (r *Client) Patch(ctx context.Context, path string, params any, res any, opts ...option.RequestOption) error

Patch makes a PATCH request with the given URL, params, and optionally deserializes to a response. See [Execute] documentation on the params and response.

func (*Client) Post 

func (r *Client) Post(ctx context.Context, path string, params any, res any, opts ...option.RequestOption) error

Post makes a POST request with the given URL, params, and optionally deserializes to a response. See [Execute] documentation on the params and response.

func (*Client) Put 

func (r *Client) Put(ctx context.Context, path string, params any, res any, opts ...option.RequestOption) error

Put makes a PUT request with the given URL, params, and optionally deserializes to a response. See [Execute] documentation on the params and response.

type CustomService added in v0.12.0 

type CustomService struct {
	// The ID of the custom service.
	ID string `json:"id"`
	// The domain for branding/logo lookup (e.g., "hr.company.com").
	Domain string `json:"domain"`
	// The name of the custom service (e.g., "Internal HR System").
	Name string `json:"name"`
	// The ID of the team that the custom service belongs to.
	TeamID string `json:"teamId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID          respjson.Field
		Domain      respjson.Field
		Name        respjson.Field
		TeamID      respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (CustomService) RawJSON added in v0.12.0 

func (r CustomService) RawJSON() string

Returns the unmodified JSON received from the API

func (*CustomService) UnmarshalJSON added in v0.12.0 

func (r *CustomService) UnmarshalJSON(data []byte) error

type CustomServiceDeleteResponse added in v0.12.0 

type CustomServiceDeleteResponse = any

type CustomServiceGetResponseEnvelope added in v0.12.0 

type CustomServiceGetResponseEnvelope struct {
	// The custom service.
	Data CustomService `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (CustomServiceGetResponseEnvelope) RawJSON added in v0.12.0 

func (r CustomServiceGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*CustomServiceGetResponseEnvelope) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceGetResponseEnvelope) UnmarshalJSON(data []byte) error

type CustomServiceListParams added in v0.12.0 

type CustomServiceListParams struct {
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// The ID of the team.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (CustomServiceListParams) URLQuery added in v0.12.0 

func (r CustomServiceListParams) URLQuery() (v url.Values, err error)

URLQuery serializes CustomServiceListParams's query parameters as `url.Values`.

type CustomServiceListResponse added in v0.12.0 

type CustomServiceListResponse struct {
	// The list of custom services.
	Data []CustomService `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (CustomServiceListResponse) RawJSON added in v0.12.0 

func (r CustomServiceListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*CustomServiceListResponse) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceListResponse) UnmarshalJSON(data []byte) error

type CustomServiceNewParams added in v0.12.0 

type CustomServiceNewParams struct {
	// The name of the custom service (e.g., "Internal HR System").
	Name string `json:"name,required"`
	// The ID of the team.
	TeamID string `json:"teamId,required"`
	// The domain for branding/logo lookup (e.g., "hr.company.com").
	Domain param.Opt[string] `json:"domain,omitzero"`
	// contains filtered or unexported fields
}

func (CustomServiceNewParams) MarshalJSON added in v0.12.0 

func (r CustomServiceNewParams) MarshalJSON() (data []byte, err error)

func (*CustomServiceNewParams) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceNewParams) UnmarshalJSON(data []byte) error

type CustomServiceNewResponseEnvelope added in v0.12.0 

type CustomServiceNewResponseEnvelope struct {
	// The created custom service.
	Data CustomService `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (CustomServiceNewResponseEnvelope) RawJSON added in v0.12.0 

func (r CustomServiceNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*CustomServiceNewResponseEnvelope) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceNewResponseEnvelope) UnmarshalJSON(data []byte) error

type CustomServiceService added in v0.12.0 

type CustomServiceService struct {
	Options []option.RequestOption
}

CustomServiceService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewCustomServiceService method instead.

func NewCustomServiceService added in v0.12.0 

func NewCustomServiceService(opts ...option.RequestOption) (r CustomServiceService)

NewCustomServiceService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*CustomServiceService) Delete added in v0.12.0 

func (r *CustomServiceService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *CustomServiceDeleteResponse, err error)

Delete a custom service. This will not delete any app instances that use this custom service.

func (*CustomServiceService) Get added in v0.12.0 

func (r *CustomServiceService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *CustomService, err error)

Get a specific custom service by ID.

func (*CustomServiceService) List added in v0.12.0 

func (r *CustomServiceService) List(ctx context.Context, query CustomServiceListParams, opts ...option.RequestOption) (res *CustomServiceListResponse, err error)

List all custom services for a team.

func (*CustomServiceService) New added in v0.12.0 

func (r *CustomServiceService) New(ctx context.Context, body CustomServiceNewParams, opts ...option.RequestOption) (res *CustomService, err error)

Create a new custom service for a team. Custom services represent external APIs or systems that are not built-in integrations.

func (*CustomServiceService) Update added in v0.12.0 

func (r *CustomServiceService) Update(ctx context.Context, id string, body CustomServiceUpdateParams, opts ...option.RequestOption) (res *CustomService, err error)

Update an existing custom service.

type CustomServiceUpdateParams added in v0.12.0 

type CustomServiceUpdateParams struct {
	// The domain for branding/logo lookup.
	Domain param.Opt[string] `json:"domain,omitzero"`
	// The name of the custom service.
	Name param.Opt[string] `json:"name,omitzero"`
	// contains filtered or unexported fields
}

func (CustomServiceUpdateParams) MarshalJSON added in v0.12.0 

func (r CustomServiceUpdateParams) MarshalJSON() (data []byte, err error)

func (*CustomServiceUpdateParams) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceUpdateParams) UnmarshalJSON(data []byte) error

type CustomServiceUpdateResponseEnvelope added in v0.12.0 

type CustomServiceUpdateResponseEnvelope struct {
	// The updated custom service.
	Data CustomService `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (CustomServiceUpdateResponseEnvelope) RawJSON added in v0.12.0 

func (r CustomServiceUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*CustomServiceUpdateResponseEnvelope) UnmarshalJSON added in v0.12.0 

func (r *CustomServiceUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type Error 

type Error = apierror.Error

type Group 

type Group struct {
	ID string `json:"id"`
	// A timestamp in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
	CreatedAt time.Time `json:"createdAt" format:"date-time"`
	// A timestamp in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
	DeletedAt      time.Time `json:"deletedAt,nullable" format:"date-time"`
	Name           string    `json:"name"`
	OrganizationID string    `json:"organizationId"`
	UserIDs        []string  `json:"userIds"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID             respjson.Field
		CreatedAt      respjson.Field
		DeletedAt      respjson.Field
		Name           respjson.Field
		OrganizationID respjson.Field
		UserIDs        respjson.Field
		ExtraFields    map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (Group) RawJSON 

func (r Group) RawJSON() string

Returns the unmodified JSON received from the API

func (*Group) UnmarshalJSON 

func (r *Group) UnmarshalJSON(data []byte) error

type GroupDeleteResponse 

type GroupDeleteResponse = any

type GroupGetResponseEnvelope 

type GroupGetResponseEnvelope struct {
	Data Group `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GroupGetResponseEnvelope) RawJSON 

func (r GroupGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GroupGetResponseEnvelope) UnmarshalJSON 

func (r *GroupGetResponseEnvelope) UnmarshalJSON(data []byte) error

type GroupListParams 

type GroupListParams struct {
	// Maximum number of results to return. Default is 5000, maximum is 5000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (GroupListParams) URLQuery 

func (r GroupListParams) URLQuery() (v url.Values, err error)

URLQuery serializes GroupListParams's query parameters as `url.Values`.

type GroupListResponse 

type GroupListResponse struct {
	// The list of groups.
	Data []Group `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GroupListResponse) RawJSON 

func (r GroupListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*GroupListResponse) UnmarshalJSON 

func (r *GroupListResponse) UnmarshalJSON(data []byte) error

type GroupNewParams 

type GroupNewParams struct {
	Name    string   `json:"name,required"`
	UserIDs []string `json:"userIds,omitzero"`
	// contains filtered or unexported fields
}

func (GroupNewParams) MarshalJSON 

func (r GroupNewParams) MarshalJSON() (data []byte, err error)

func (*GroupNewParams) UnmarshalJSON 

func (r *GroupNewParams) UnmarshalJSON(data []byte) error

type GroupNewResponseEnvelope 

type GroupNewResponseEnvelope struct {
	Data Group `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GroupNewResponseEnvelope) RawJSON 

func (r GroupNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GroupNewResponseEnvelope) UnmarshalJSON 

func (r *GroupNewResponseEnvelope) UnmarshalJSON(data []byte) error

type GroupService 

type GroupService struct {
	Options []option.RequestOption
}

GroupService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewGroupService method instead.

func NewGroupService 

func NewGroupService(opts ...option.RequestOption) (r GroupService)

NewGroupService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*GroupService) Delete 

func (r *GroupService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *GroupDeleteResponse, err error)

Delete a group.

func (*GroupService) Get 

func (r *GroupService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *Group, err error)

Get a specific group by ID.

func (*GroupService) List 

func (r *GroupService) List(ctx context.Context, query GroupListParams, opts ...option.RequestOption) (res *GroupListResponse, err error)

List all groups.

func (*GroupService) New 

func (r *GroupService) New(ctx context.Context, body GroupNewParams, opts ...option.RequestOption) (res *Group, err error)

Create a new group.

func (*GroupService) Update 

func (r *GroupService) Update(ctx context.Context, id string, body GroupUpdateParams, opts ...option.RequestOption) (res *Group, err error)

Update an existing group.

type GroupUpdateParams 

type GroupUpdateParams struct {
	Name    param.Opt[string] `json:"name,omitzero"`
	UserIDs []string          `json:"userIds,omitzero"`
	// contains filtered or unexported fields
}

func (GroupUpdateParams) MarshalJSON 

func (r GroupUpdateParams) MarshalJSON() (data []byte, err error)

func (*GroupUpdateParams) UnmarshalJSON 

func (r *GroupUpdateParams) UnmarshalJSON(data []byte) error

type GroupUpdateResponseEnvelope 

type GroupUpdateResponseEnvelope struct {
	Data Group `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GroupUpdateResponseEnvelope) RawJSON 

func (r GroupUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GroupUpdateResponseEnvelope) UnmarshalJSON 

func (r *GroupUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type Guidance 

type Guidance struct {
	// The ID of the guidance.
	ID string `json:"id"`
	// The content of the guidance.
	Content string `json:"content"`
	// A description of the guidance.
	Description string `json:"description"`
	// Whether there are unpublished changes to the guidance (computed by server).
	HasUnpublishedChanges bool `json:"hasUnpublishedChanges"`
	// Whether the guidance is published. Set to true to publish the guidance.
	IsPublished bool `json:"isPublished"`
	// The name of the guidance.
	Name string `json:"name"`
	// Whether this guidance should always be used (skipping LLM selection).
	ShouldAlwaysUse bool `json:"shouldAlwaysUse"`
	// The ID of the team that the guidance belongs to.
	TeamID string `json:"teamId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                    respjson.Field
		Content               respjson.Field
		Description           respjson.Field
		HasUnpublishedChanges respjson.Field
		IsPublished           respjson.Field
		Name                  respjson.Field
		ShouldAlwaysUse       respjson.Field
		TeamID                respjson.Field
		ExtraFields           map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (Guidance) RawJSON 

func (r Guidance) RawJSON() string

Returns the unmodified JSON received from the API

func (*Guidance) UnmarshalJSON 

func (r *Guidance) UnmarshalJSON(data []byte) error

type GuidanceDeleteResponse 

type GuidanceDeleteResponse = any

type GuidanceGetResponseEnvelope 

type GuidanceGetResponseEnvelope struct {
	// The guidance.
	Data Guidance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GuidanceGetResponseEnvelope) RawJSON 

func (r GuidanceGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GuidanceGetResponseEnvelope) UnmarshalJSON 

func (r *GuidanceGetResponseEnvelope) UnmarshalJSON(data []byte) error

type GuidanceListParams 

type GuidanceListParams struct {
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// The ID of the team.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (GuidanceListParams) URLQuery 

func (r GuidanceListParams) URLQuery() (v url.Values, err error)

URLQuery serializes GuidanceListParams's query parameters as `url.Values`.

type GuidanceListResponse added in v0.6.0 

type GuidanceListResponse struct {
	// The list of guidances.
	Data []Guidance `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GuidanceListResponse) RawJSON added in v0.6.0 

func (r GuidanceListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*GuidanceListResponse) UnmarshalJSON added in v0.6.0 

func (r *GuidanceListResponse) UnmarshalJSON(data []byte) error

type GuidanceNewParams 

type GuidanceNewParams struct {
	// The content of the guidance.
	Content string `json:"content,required"`
	// The name of the guidance.
	Name string `json:"name,required"`
	// The ID of the team.
	TeamID string `json:"teamId,required"`
	// Whether to publish the guidance after creation (optional).
	IsPublished param.Opt[bool] `json:"isPublished,omitzero"`
	// Whether this guidance should always be used (optional, defaults to false).
	ShouldAlwaysUse param.Opt[bool] `json:"shouldAlwaysUse,omitzero"`
	// A description of the guidance.
	Description param.Opt[string] `json:"description,omitzero"`
	// contains filtered or unexported fields
}

func (GuidanceNewParams) MarshalJSON 

func (r GuidanceNewParams) MarshalJSON() (data []byte, err error)

func (*GuidanceNewParams) UnmarshalJSON 

func (r *GuidanceNewParams) UnmarshalJSON(data []byte) error

type GuidanceNewResponseEnvelope 

type GuidanceNewResponseEnvelope struct {
	// The created guidance.
	Data Guidance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GuidanceNewResponseEnvelope) RawJSON 

func (r GuidanceNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GuidanceNewResponseEnvelope) UnmarshalJSON 

func (r *GuidanceNewResponseEnvelope) UnmarshalJSON(data []byte) error

type GuidanceService 

type GuidanceService struct {
	Options []option.RequestOption
}

GuidanceService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewGuidanceService method instead.

func NewGuidanceService 

func NewGuidanceService(opts ...option.RequestOption) (r GuidanceService)

NewGuidanceService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*GuidanceService) Delete 

func (r *GuidanceService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *GuidanceDeleteResponse, err error)

Delete a guidance.

func (*GuidanceService) Get 

func (r *GuidanceService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *Guidance, err error)

Get a specific guidance by ID.

func (*GuidanceService) List 

func (r *GuidanceService) List(ctx context.Context, query GuidanceListParams, opts ...option.RequestOption) (res *GuidanceListResponse, err error)

List all guidances for a team.

func (*GuidanceService) New 

func (r *GuidanceService) New(ctx context.Context, body GuidanceNewParams, opts ...option.RequestOption) (res *Guidance, err error)

Create a new guidance for a team.

func (*GuidanceService) Update 

func (r *GuidanceService) Update(ctx context.Context, id string, body GuidanceUpdateParams, opts ...option.RequestOption) (res *Guidance, err error)

Update an existing guidance.

type GuidanceUpdateParams 

type GuidanceUpdateParams struct {
	// Whether the guidance is published. Set to true to publish the guidance.
	IsPublished param.Opt[bool] `json:"isPublished,omitzero"`
	// Whether this guidance should always be used (optional).
	ShouldAlwaysUse param.Opt[bool] `json:"shouldAlwaysUse,omitzero"`
	// The content of the guidance.
	Content param.Opt[string] `json:"content,omitzero"`
	// A description of the guidance.
	Description param.Opt[string] `json:"description,omitzero"`
	// The name of the guidance.
	Name param.Opt[string] `json:"name,omitzero"`
	// contains filtered or unexported fields
}

func (GuidanceUpdateParams) MarshalJSON 

func (r GuidanceUpdateParams) MarshalJSON() (data []byte, err error)

func (*GuidanceUpdateParams) UnmarshalJSON 

func (r *GuidanceUpdateParams) UnmarshalJSON(data []byte) error

type GuidanceUpdateResponseEnvelope 

type GuidanceUpdateResponseEnvelope struct {
	// The updated guidance.
	Data Guidance `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (GuidanceUpdateResponseEnvelope) RawJSON 

func (r GuidanceUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*GuidanceUpdateResponseEnvelope) UnmarshalJSON 

func (r *GuidanceUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type Team 

type Team struct {
	ID string `json:"id"`
	// A timestamp in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
	CreatedAt      time.Time `json:"createdAt" format:"date-time"`
	Description    string    `json:"description"`
	Name           string    `json:"name"`
	OrganizationID string    `json:"organizationId"`
	Prefix         string    `json:"prefix"`
	UserIDs        []string  `json:"userIds"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID             respjson.Field
		CreatedAt      respjson.Field
		Description    respjson.Field
		Name           respjson.Field
		OrganizationID respjson.Field
		Prefix         respjson.Field
		UserIDs        respjson.Field
		ExtraFields    map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (Team) RawJSON 

func (r Team) RawJSON() string

Returns the unmodified JSON received from the API

func (*Team) UnmarshalJSON 

func (r *Team) UnmarshalJSON(data []byte) error

type TeamDeleteResponse 

type TeamDeleteResponse = any

type TeamGetResponseEnvelope 

type TeamGetResponseEnvelope struct {
	Data Team `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (TeamGetResponseEnvelope) RawJSON 

func (r TeamGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*TeamGetResponseEnvelope) UnmarshalJSON 

func (r *TeamGetResponseEnvelope) UnmarshalJSON(data []byte) error

type TeamListParams 

type TeamListParams struct {
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (TeamListParams) URLQuery 

func (r TeamListParams) URLQuery() (v url.Values, err error)

URLQuery serializes TeamListParams's query parameters as `url.Values`.

type TeamListResponse 

type TeamListResponse struct {
	// The list of teams.
	Data []Team `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (TeamListResponse) RawJSON 

func (r TeamListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*TeamListResponse) UnmarshalJSON 

func (r *TeamListResponse) UnmarshalJSON(data []byte) error

type TeamNewParams 

type TeamNewParams struct {
	Name        string            `json:"name,required"`
	Description param.Opt[string] `json:"description,omitzero"`
	Prefix      param.Opt[string] `json:"prefix,omitzero"`
	UserIDs     []string          `json:"userIds,omitzero"`
	// contains filtered or unexported fields
}

func (TeamNewParams) MarshalJSON 

func (r TeamNewParams) MarshalJSON() (data []byte, err error)

func (*TeamNewParams) UnmarshalJSON 

func (r *TeamNewParams) UnmarshalJSON(data []byte) error

type TeamNewResponseEnvelope 

type TeamNewResponseEnvelope struct {
	Data Team `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (TeamNewResponseEnvelope) RawJSON 

func (r TeamNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*TeamNewResponseEnvelope) UnmarshalJSON 

func (r *TeamNewResponseEnvelope) UnmarshalJSON(data []byte) error

type TeamService 

type TeamService struct {
	Options []option.RequestOption
}

TeamService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewTeamService method instead.

func NewTeamService 

func NewTeamService(opts ...option.RequestOption) (r TeamService)

NewTeamService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*TeamService) Delete 

func (r *TeamService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *TeamDeleteResponse, err error)

Delete a team.

func (*TeamService) Get 

func (r *TeamService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *Team, err error)

Get a specific team by ID.

func (*TeamService) List 

func (r *TeamService) List(ctx context.Context, query TeamListParams, opts ...option.RequestOption) (res *TeamListResponse, err error)

List all teams.

func (*TeamService) New 

func (r *TeamService) New(ctx context.Context, body TeamNewParams, opts ...option.RequestOption) (res *Team, err error)

Create a new team.

func (*TeamService) Update 

func (r *TeamService) Update(ctx context.Context, id string, body TeamUpdateParams, opts ...option.RequestOption) (res *Team, err error)

Update an existing team.

type TeamUpdateParams 

type TeamUpdateParams struct {
	Description param.Opt[string] `json:"description,omitzero"`
	Name        param.Opt[string] `json:"name,omitzero"`
	Prefix      param.Opt[string] `json:"prefix,omitzero"`
	UserIDs     []string          `json:"userIds,omitzero"`
	// contains filtered or unexported fields
}

func (TeamUpdateParams) MarshalJSON 

func (r TeamUpdateParams) MarshalJSON() (data []byte, err error)

func (*TeamUpdateParams) UnmarshalJSON 

func (r *TeamUpdateParams) UnmarshalJSON(data []byte) error

type TeamUpdateResponseEnvelope 

type TeamUpdateResponseEnvelope struct {
	Data Team `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (TeamUpdateResponseEnvelope) RawJSON 

func (r TeamUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*TeamUpdateResponseEnvelope) UnmarshalJSON 

func (r *TeamUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type User 

type User struct {
	ID        string `json:"id"`
	AvatarURL string `json:"avatarUrl"`
	// A timestamp in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
	CreatedAt time.Time `json:"createdAt" format:"date-time"`
	// A timestamp in RFC 3339 format (e.g., "2017-01-15T01:30:15.01Z").
	DeactivatedAt time.Time `json:"deactivatedAt,nullable" format:"date-time"`
	Email         string    `json:"email"`
	FirstName     string    `json:"firstName"`
	LastName      string    `json:"lastName"`
	Name          string    `json:"name"`
	// Any of "USER_ROLE_UNSPECIFIED", "USER_ROLE_ORG_MEMBER", "USER_ROLE_ORG_ADMIN",
	// "USER_ROLE_ORG_GUEST".
	Role UserRole `json:"role"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID            respjson.Field
		AvatarURL     respjson.Field
		CreatedAt     respjson.Field
		DeactivatedAt respjson.Field
		Email         respjson.Field
		FirstName     respjson.Field
		LastName      respjson.Field
		Name          respjson.Field
		Role          respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (User) RawJSON 

func (r User) RawJSON() string

Returns the unmodified JSON received from the API

func (*User) UnmarshalJSON 

func (r *User) UnmarshalJSON(data []byte) error

type UserDeleteResponse 

type UserDeleteResponse = any

type UserGetResponseEnvelope 

type UserGetResponseEnvelope struct {
	Data User `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (UserGetResponseEnvelope) RawJSON 

func (r UserGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*UserGetResponseEnvelope) UnmarshalJSON 

func (r *UserGetResponseEnvelope) UnmarshalJSON(data []byte) error

type UserListParams 

type UserListParams struct {
	// Whether to include deactivated users in the response.
	IncludeDeactivated param.Opt[bool] `query:"includeDeactivated,omitzero" json:"-"`
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (UserListParams) URLQuery 

func (r UserListParams) URLQuery() (v url.Values, err error)

URLQuery serializes UserListParams's query parameters as `url.Values`.

type UserListResponse 

type UserListResponse struct {
	// The list of users.
	Data []User `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (UserListResponse) RawJSON 

func (r UserListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*UserListResponse) UnmarshalJSON 

func (r *UserListResponse) UnmarshalJSON(data []byte) error

type UserNewParams 

type UserNewParams struct {
	Email     string            `json:"email,required"`
	FirstName param.Opt[string] `json:"firstName,omitzero"`
	LastName  param.Opt[string] `json:"lastName,omitzero"`
	// Any of "USER_ROLE_UNSPECIFIED", "USER_ROLE_ORG_MEMBER", "USER_ROLE_ORG_ADMIN",
	// "USER_ROLE_ORG_GUEST".
	Role UserNewParamsRole `json:"role,omitzero"`
	// contains filtered or unexported fields
}

func (UserNewParams) MarshalJSON 

func (r UserNewParams) MarshalJSON() (data []byte, err error)

func (*UserNewParams) UnmarshalJSON 

func (r *UserNewParams) UnmarshalJSON(data []byte) error

type UserNewParamsRole 

type UserNewParamsRole string
const (
	UserNewParamsRoleUserRoleUnspecified UserNewParamsRole = "USER_ROLE_UNSPECIFIED"
	UserNewParamsRoleUserRoleOrgMember   UserNewParamsRole = "USER_ROLE_ORG_MEMBER"
	UserNewParamsRoleUserRoleOrgAdmin    UserNewParamsRole = "USER_ROLE_ORG_ADMIN"
	UserNewParamsRoleUserRoleOrgGuest    UserNewParamsRole = "USER_ROLE_ORG_GUEST"
)

type UserNewResponseEnvelope 

type UserNewResponseEnvelope struct {
	Data User `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (UserNewResponseEnvelope) RawJSON 

func (r UserNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*UserNewResponseEnvelope) UnmarshalJSON 

func (r *UserNewResponseEnvelope) UnmarshalJSON(data []byte) error

type UserRole 

type UserRole string
const (
	UserRoleUserRoleUnspecified UserRole = "USER_ROLE_UNSPECIFIED"
	UserRoleUserRoleOrgMember   UserRole = "USER_ROLE_ORG_MEMBER"
	UserRoleUserRoleOrgAdmin    UserRole = "USER_ROLE_ORG_ADMIN"
	UserRoleUserRoleOrgGuest    UserRole = "USER_ROLE_ORG_GUEST"
)

type UserService 

type UserService struct {
	Options []option.RequestOption
}

UserService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewUserService method instead.

func NewUserService 

func NewUserService(opts ...option.RequestOption) (r UserService)

NewUserService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*UserService) Delete 

func (r *UserService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *UserDeleteResponse, err error)

Delete a user.

func (*UserService) Get 

func (r *UserService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *User, err error)

Get a specific user by ID.

func (*UserService) List 

func (r *UserService) List(ctx context.Context, query UserListParams, opts ...option.RequestOption) (res *UserListResponse, err error)

List all users.

func (*UserService) New 

func (r *UserService) New(ctx context.Context, body UserNewParams, opts ...option.RequestOption) (res *User, err error)

Create a new user.

func (*UserService) Update 

func (r *UserService) Update(ctx context.Context, id string, body UserUpdateParams, opts ...option.RequestOption) (res *User, err error)

Update an existing user.

type UserUpdateParams 

type UserUpdateParams struct {
	AvatarURL param.Opt[string] `json:"avatarUrl,omitzero"`
	Email     param.Opt[string] `json:"email,omitzero"`
	FirstName param.Opt[string] `json:"firstName,omitzero"`
	LastName  param.Opt[string] `json:"lastName,omitzero"`
	// Any of "USER_ROLE_UNSPECIFIED", "USER_ROLE_ORG_MEMBER", "USER_ROLE_ORG_ADMIN",
	// "USER_ROLE_ORG_GUEST".
	Role UserUpdateParamsRole `json:"role,omitzero"`
	// contains filtered or unexported fields
}

func (UserUpdateParams) MarshalJSON 

func (r UserUpdateParams) MarshalJSON() (data []byte, err error)

func (*UserUpdateParams) UnmarshalJSON 

func (r *UserUpdateParams) UnmarshalJSON(data []byte) error

type UserUpdateParamsRole 

type UserUpdateParamsRole string
const (
	UserUpdateParamsRoleUserRoleUnspecified UserUpdateParamsRole = "USER_ROLE_UNSPECIFIED"
	UserUpdateParamsRoleUserRoleOrgMember   UserUpdateParamsRole = "USER_ROLE_ORG_MEMBER"
	UserUpdateParamsRoleUserRoleOrgAdmin    UserUpdateParamsRole = "USER_ROLE_ORG_ADMIN"
	UserUpdateParamsRoleUserRoleOrgGuest    UserUpdateParamsRole = "USER_ROLE_ORG_GUEST"
)

type UserUpdateResponseEnvelope 

type UserUpdateResponseEnvelope struct {
	Data User `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (UserUpdateResponseEnvelope) RawJSON 

func (r UserUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*UserUpdateResponseEnvelope) UnmarshalJSON 

func (r *UserUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type Workflow 

type Workflow struct {
	// The ID of the workflow.
	ID string `json:"id"`
	// The content/code of the workflow.
	Content string `json:"content"`
	// A description of the workflow.
	Description string `json:"description"`
	// The execution scope of the workflow.
	//
	// Any of "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED", "TEAM_PRIVATE", "TEAM_PUBLIC".
	ExecutionScope WorkflowExecutionScope `json:"executionScope"`
	// Whether there are unpublished changes to the workflow (computed by server).
	HasUnpublishedChanges bool `json:"hasUnpublishedChanges"`
	// Whether the workflow is published. Set to true to publish the workflow.
	IsPublished bool `json:"isPublished"`
	// Whether the workflow is temporary.
	IsTemporary bool `json:"isTemporary"`
	// The name of the workflow.
	Name string `json:"name"`
	// The parameters schema of the workflow (JSON).
	Parameters string `json:"parameters"`
	// Whether the workflow requires form confirmation.
	RequireFormConfirmation bool `json:"requireFormConfirmation"`
	// IDs of tags associated with this workflow.
	TagIDs []string `json:"tagIds"`
	// The ID of the team that the workflow belongs to.
	TeamID string `json:"teamId"`
	// The type of the workflow.
	//
	// Any of "WORKFLOW_TYPE_UNSPECIFIED", "EXECUTABLE", "GUIDANCE".
	Type WorkflowType `json:"type"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                      respjson.Field
		Content                 respjson.Field
		Description             respjson.Field
		ExecutionScope          respjson.Field
		HasUnpublishedChanges   respjson.Field
		IsPublished             respjson.Field
		IsTemporary             respjson.Field
		Name                    respjson.Field
		Parameters              respjson.Field
		RequireFormConfirmation respjson.Field
		TagIDs                  respjson.Field
		TeamID                  respjson.Field
		Type                    respjson.Field
		ExtraFields             map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (Workflow) RawJSON 

func (r Workflow) RawJSON() string

Returns the unmodified JSON received from the API

func (*Workflow) UnmarshalJSON 

func (r *Workflow) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedure 

type WorkflowApprovalProcedure struct {
	// The ID of the workflow approval procedure.
	ID string `json:"id"`
	// The steps in the approval procedure.
	Steps []WorkflowApprovalProcedureStep `json:"steps"`
	// The ID of the workflow this approval procedure belongs to.
	WorkflowID string `json:"workflowId"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID          respjson.Field
		Steps       respjson.Field
		WorkflowID  respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedure) RawJSON 

func (r WorkflowApprovalProcedure) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedure) UnmarshalJSON 

func (r *WorkflowApprovalProcedure) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureDeleteParams 

type WorkflowApprovalProcedureDeleteParams struct {
	// The ID of the workflow.
	WorkflowID string `path:"workflow_id,required" json:"-"`
	// contains filtered or unexported fields
}

type WorkflowApprovalProcedureDeleteResponse 

type WorkflowApprovalProcedureDeleteResponse = any

type WorkflowApprovalProcedureGetParams 

type WorkflowApprovalProcedureGetParams struct {
	// The ID of the workflow.
	WorkflowID string `path:"workflow_id,required" json:"-"`
	// contains filtered or unexported fields
}

type WorkflowApprovalProcedureGetResponseEnvelope 

type WorkflowApprovalProcedureGetResponseEnvelope struct {
	// The approval procedure.
	Data WorkflowApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedureGetResponseEnvelope) RawJSON 

func (r WorkflowApprovalProcedureGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedureGetResponseEnvelope) UnmarshalJSON 

func (r *WorkflowApprovalProcedureGetResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureListResponseEnvelope 

type WorkflowApprovalProcedureListResponseEnvelope struct {
	// The list of approval procedures (typically 0 or 1).
	Data []WorkflowApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedureListResponseEnvelope) RawJSON 

func (r WorkflowApprovalProcedureListResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedureListResponseEnvelope) UnmarshalJSON 

func (r *WorkflowApprovalProcedureListResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureNewParams 

type WorkflowApprovalProcedureNewParams struct {
	// The approval steps for the procedure.
	Steps []WorkflowApprovalProcedureNewParamsStep `json:"steps,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowApprovalProcedureNewParams) MarshalJSON 

func (r WorkflowApprovalProcedureNewParams) MarshalJSON() (data []byte, err error)

func (*WorkflowApprovalProcedureNewParams) UnmarshalJSON 

func (r *WorkflowApprovalProcedureNewParams) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureNewParamsStep 

type WorkflowApprovalProcedureNewParamsStep struct {
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval param.Opt[bool] `json:"allowSelfApproval,omitzero"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID param.Opt[string] `json:"customWorkflowId,omitzero"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds,omitzero"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowApprovalProcedureNewParamsStep) MarshalJSON 

func (r WorkflowApprovalProcedureNewParamsStep) MarshalJSON() (data []byte, err error)

func (*WorkflowApprovalProcedureNewParamsStep) UnmarshalJSON 

func (r *WorkflowApprovalProcedureNewParamsStep) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureNewResponseEnvelope 

type WorkflowApprovalProcedureNewResponseEnvelope struct {
	// The created approval procedure.
	Data WorkflowApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedureNewResponseEnvelope) RawJSON 

func (r WorkflowApprovalProcedureNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedureNewResponseEnvelope) UnmarshalJSON 

func (r *WorkflowApprovalProcedureNewResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureService 

type WorkflowApprovalProcedureService struct {
	Options []option.RequestOption
}

WorkflowApprovalProcedureService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewWorkflowApprovalProcedureService method instead.

func NewWorkflowApprovalProcedureService 

func NewWorkflowApprovalProcedureService(opts ...option.RequestOption) (r WorkflowApprovalProcedureService)

NewWorkflowApprovalProcedureService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*WorkflowApprovalProcedureService) Delete 

func (r *WorkflowApprovalProcedureService) Delete(ctx context.Context, id string, body WorkflowApprovalProcedureDeleteParams, opts ...option.RequestOption) (res *WorkflowApprovalProcedureDeleteResponse, err error)

Delete an approval procedure for a workflow.

func (*WorkflowApprovalProcedureService) Get 

func (r *WorkflowApprovalProcedureService) Get(ctx context.Context, id string, query WorkflowApprovalProcedureGetParams, opts ...option.RequestOption) (res *WorkflowApprovalProcedure, err error)

Get a specific approval procedure by ID for a workflow.

func (*WorkflowApprovalProcedureService) List 

func (r *WorkflowApprovalProcedureService) List(ctx context.Context, workflowID string, opts ...option.RequestOption) (res *[]WorkflowApprovalProcedure, err error)

List all approval procedures for a workflow.

func (*WorkflowApprovalProcedureService) New 

func (r *WorkflowApprovalProcedureService) New(ctx context.Context, workflowID string, body WorkflowApprovalProcedureNewParams, opts ...option.RequestOption) (res *WorkflowApprovalProcedure, err error)

Create a new approval procedure for a workflow.

func (*WorkflowApprovalProcedureService) Update 

func (r *WorkflowApprovalProcedureService) Update(ctx context.Context, id string, params WorkflowApprovalProcedureUpdateParams, opts ...option.RequestOption) (res *WorkflowApprovalProcedure, err error)

Update an existing approval procedure for a workflow.

type WorkflowApprovalProcedureStep 

type WorkflowApprovalProcedureStep struct {
	// The ID of the approval step.
	ID string `json:"id"`
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval bool `json:"allowSelfApproval"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID string `json:"customWorkflowId"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		ID                respjson.Field
		AllowSelfApproval respjson.Field
		CustomWorkflowID  respjson.Field
		ServalGroupIDs    respjson.Field
		SpecificUserIDs   respjson.Field
		ExtraFields       map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedureStep) RawJSON 

func (r WorkflowApprovalProcedureStep) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedureStep) UnmarshalJSON 

func (r *WorkflowApprovalProcedureStep) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureUpdateParams 

type WorkflowApprovalProcedureUpdateParams struct {
	// The ID of the workflow.
	WorkflowID string `path:"workflow_id,required" json:"-"`
	// The approval steps for the procedure.
	Steps []WorkflowApprovalProcedureUpdateParamsStep `json:"steps,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowApprovalProcedureUpdateParams) MarshalJSON 

func (r WorkflowApprovalProcedureUpdateParams) MarshalJSON() (data []byte, err error)

func (*WorkflowApprovalProcedureUpdateParams) UnmarshalJSON 

func (r *WorkflowApprovalProcedureUpdateParams) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureUpdateParamsStep 

type WorkflowApprovalProcedureUpdateParamsStep struct {
	// Whether the step can be approved by the requester themselves.
	AllowSelfApproval param.Opt[bool] `json:"allowSelfApproval,omitzero"`
	// A workflow ID to execute to determine the approvers for this step (or to
	// auto-approve the step).
	CustomWorkflowID param.Opt[string] `json:"customWorkflowId,omitzero"`
	// The IDs of the Serval groups that can approve the step.
	ServalGroupIDs []string `json:"servalGroupIds,omitzero"`
	// The IDs of the specific users that can approve the step.
	SpecificUserIDs []string `json:"specificUserIds,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowApprovalProcedureUpdateParamsStep) MarshalJSON 

func (r WorkflowApprovalProcedureUpdateParamsStep) MarshalJSON() (data []byte, err error)

func (*WorkflowApprovalProcedureUpdateParamsStep) UnmarshalJSON 

func (r *WorkflowApprovalProcedureUpdateParamsStep) UnmarshalJSON(data []byte) error

type WorkflowApprovalProcedureUpdateResponseEnvelope 

type WorkflowApprovalProcedureUpdateResponseEnvelope struct {
	// The updated approval procedure.
	Data WorkflowApprovalProcedure `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowApprovalProcedureUpdateResponseEnvelope) RawJSON 

func (r WorkflowApprovalProcedureUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowApprovalProcedureUpdateResponseEnvelope) UnmarshalJSON 

func (r *WorkflowApprovalProcedureUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowDeleteResponse 

type WorkflowDeleteResponse = any

type WorkflowExecutionScope 

type WorkflowExecutionScope string

The execution scope of the workflow. 

const (
	WorkflowExecutionScopeWorkflowExecutionScopeUnspecified WorkflowExecutionScope = "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED"
	WorkflowExecutionScopeTeamPrivate                       WorkflowExecutionScope = "TEAM_PRIVATE"
	WorkflowExecutionScopeTeamPublic                        WorkflowExecutionScope = "TEAM_PUBLIC"
)

type WorkflowGetResponseEnvelope 

type WorkflowGetResponseEnvelope struct {
	// The workflow.
	Data Workflow `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowGetResponseEnvelope) RawJSON 

func (r WorkflowGetResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowGetResponseEnvelope) UnmarshalJSON 

func (r *WorkflowGetResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowListParams 

type WorkflowListParams struct {
	// Whether to include temporary workflows (optional, defaults to false).
	IncludeTemporary param.Opt[bool] `query:"includeTemporary,omitzero" json:"-"`
	// Maximum number of results to return. Default is 1000, maximum is 1000.
	PageSize param.Opt[int64] `query:"pageSize,omitzero" json:"-"`
	// Token for pagination. Leave empty for the first request.
	PageToken param.Opt[string] `query:"pageToken,omitzero" json:"-"`
	// The ID of the team.
	TeamID param.Opt[string] `query:"teamId,omitzero" json:"-"`
	// contains filtered or unexported fields
}

func (WorkflowListParams) URLQuery 

func (r WorkflowListParams) URLQuery() (v url.Values, err error)

URLQuery serializes WorkflowListParams's query parameters as `url.Values`.

type WorkflowListResponse added in v0.6.0 

type WorkflowListResponse struct {
	// The list of workflows.
	Data []Workflow `json:"data"`
	// Token for retrieving the next page of results. Empty if no more results.
	NextPageToken string `json:"nextPageToken,nullable"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data          respjson.Field
		NextPageToken respjson.Field
		ExtraFields   map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowListResponse) RawJSON added in v0.6.0 

func (r WorkflowListResponse) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowListResponse) UnmarshalJSON added in v0.6.0 

func (r *WorkflowListResponse) UnmarshalJSON(data []byte) error

type WorkflowNewParams 

type WorkflowNewParams struct {
	// The content/code of the workflow.
	Content string `json:"content,required"`
	// The name of the workflow.
	Name string `json:"name,required"`
	// The ID of the team.
	TeamID string `json:"teamId,required"`
	// The type of the workflow.
	//
	// Any of "WORKFLOW_TYPE_UNSPECIFIED", "EXECUTABLE", "GUIDANCE".
	Type WorkflowNewParamsType `json:"type,omitzero,required"`
	// Whether to publish the workflow after creation (optional).
	IsPublished param.Opt[bool] `json:"isPublished,omitzero"`
	// Whether the workflow is temporary (optional).
	IsTemporary param.Opt[bool] `json:"isTemporary,omitzero"`
	// The parameters schema of the workflow (JSON, optional).
	Parameters param.Opt[string] `json:"parameters,omitzero"`
	// Whether the workflow requires form confirmation (optional).
	RequireFormConfirmation param.Opt[bool] `json:"requireFormConfirmation,omitzero"`
	// A description of the workflow.
	Description param.Opt[string] `json:"description,omitzero"`
	// The execution scope of the workflow.
	//
	// Any of "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED", "TEAM_PRIVATE", "TEAM_PUBLIC".
	ExecutionScope WorkflowNewParamsExecutionScope `json:"executionScope,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowNewParams) MarshalJSON 

func (r WorkflowNewParams) MarshalJSON() (data []byte, err error)

func (*WorkflowNewParams) UnmarshalJSON 

func (r *WorkflowNewParams) UnmarshalJSON(data []byte) error

type WorkflowNewParamsExecutionScope 

type WorkflowNewParamsExecutionScope string

The execution scope of the workflow. 

const (
	WorkflowNewParamsExecutionScopeWorkflowExecutionScopeUnspecified WorkflowNewParamsExecutionScope = "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED"
	WorkflowNewParamsExecutionScopeTeamPrivate                       WorkflowNewParamsExecutionScope = "TEAM_PRIVATE"
	WorkflowNewParamsExecutionScopeTeamPublic                        WorkflowNewParamsExecutionScope = "TEAM_PUBLIC"
)

type WorkflowNewParamsType 

type WorkflowNewParamsType string

The type of the workflow. 

const (
	WorkflowNewParamsTypeWorkflowTypeUnspecified WorkflowNewParamsType = "WORKFLOW_TYPE_UNSPECIFIED"
	WorkflowNewParamsTypeExecutable              WorkflowNewParamsType = "EXECUTABLE"
	WorkflowNewParamsTypeGuidance                WorkflowNewParamsType = "GUIDANCE"
)

type WorkflowNewResponseEnvelope 

type WorkflowNewResponseEnvelope struct {
	// The created workflow.
	Data Workflow `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowNewResponseEnvelope) RawJSON 

func (r WorkflowNewResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowNewResponseEnvelope) UnmarshalJSON 

func (r *WorkflowNewResponseEnvelope) UnmarshalJSON(data []byte) error

type WorkflowService 

type WorkflowService struct {
	Options            []option.RequestOption
	ApprovalProcedures WorkflowApprovalProcedureService
}

WorkflowService contains methods and other services that help with interacting with the serval API.

Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewWorkflowService method instead.

func NewWorkflowService 

func NewWorkflowService(opts ...option.RequestOption) (r WorkflowService)

NewWorkflowService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.

func (*WorkflowService) Delete 

func (r *WorkflowService) Delete(ctx context.Context, id string, opts ...option.RequestOption) (res *WorkflowDeleteResponse, err error)

Delete a workflow.

func (*WorkflowService) Get 

func (r *WorkflowService) Get(ctx context.Context, id string, opts ...option.RequestOption) (res *Workflow, err error)

Get a specific workflow by ID.

func (*WorkflowService) List 

func (r *WorkflowService) List(ctx context.Context, query WorkflowListParams, opts ...option.RequestOption) (res *WorkflowListResponse, err error)

List all workflows for a team.

func (*WorkflowService) New 

func (r *WorkflowService) New(ctx context.Context, body WorkflowNewParams, opts ...option.RequestOption) (res *Workflow, err error)

Create a new workflow for a team.

func (*WorkflowService) Update 

func (r *WorkflowService) Update(ctx context.Context, id string, body WorkflowUpdateParams, opts ...option.RequestOption) (res *Workflow, err error)

Update an existing workflow.

type WorkflowType 

type WorkflowType string

The type of the workflow. 

const (
	WorkflowTypeWorkflowTypeUnspecified WorkflowType = "WORKFLOW_TYPE_UNSPECIFIED"
	WorkflowTypeExecutable              WorkflowType = "EXECUTABLE"
	WorkflowTypeGuidance                WorkflowType = "GUIDANCE"
)

type WorkflowUpdateParams 

type WorkflowUpdateParams struct {
	// Whether the workflow is published. Set to true to publish the workflow.
	IsPublished param.Opt[bool] `json:"isPublished,omitzero"`
	// The content/code of the workflow.
	Content param.Opt[string] `json:"content,omitzero"`
	// A description of the workflow.
	Description param.Opt[string] `json:"description,omitzero"`
	// Whether the workflow is temporary.
	IsTemporary param.Opt[bool] `json:"isTemporary,omitzero"`
	// The name of the workflow.
	Name param.Opt[string] `json:"name,omitzero"`
	// The parameters schema of the workflow (JSON).
	Parameters param.Opt[string] `json:"parameters,omitzero"`
	// Whether the workflow requires form confirmation.
	RequireFormConfirmation param.Opt[bool] `json:"requireFormConfirmation,omitzero"`
	// The execution scope of the workflow.
	//
	// Any of "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED", "TEAM_PRIVATE", "TEAM_PUBLIC".
	ExecutionScope WorkflowUpdateParamsExecutionScope `json:"executionScope,omitzero"`
	// The type of the workflow.
	//
	// Any of "WORKFLOW_TYPE_UNSPECIFIED", "EXECUTABLE", "GUIDANCE".
	Type WorkflowUpdateParamsType `json:"type,omitzero"`
	// contains filtered or unexported fields
}

func (WorkflowUpdateParams) MarshalJSON 

func (r WorkflowUpdateParams) MarshalJSON() (data []byte, err error)

func (*WorkflowUpdateParams) UnmarshalJSON 

func (r *WorkflowUpdateParams) UnmarshalJSON(data []byte) error

type WorkflowUpdateParamsExecutionScope 

type WorkflowUpdateParamsExecutionScope string

The execution scope of the workflow. 

const (
	WorkflowUpdateParamsExecutionScopeWorkflowExecutionScopeUnspecified WorkflowUpdateParamsExecutionScope = "WORKFLOW_EXECUTION_SCOPE_UNSPECIFIED"
	WorkflowUpdateParamsExecutionScopeTeamPrivate                       WorkflowUpdateParamsExecutionScope = "TEAM_PRIVATE"
	WorkflowUpdateParamsExecutionScopeTeamPublic                        WorkflowUpdateParamsExecutionScope = "TEAM_PUBLIC"
)

type WorkflowUpdateParamsType 

type WorkflowUpdateParamsType string

The type of the workflow. 

const (
	WorkflowUpdateParamsTypeWorkflowTypeUnspecified WorkflowUpdateParamsType = "WORKFLOW_TYPE_UNSPECIFIED"
	WorkflowUpdateParamsTypeExecutable              WorkflowUpdateParamsType = "EXECUTABLE"
	WorkflowUpdateParamsTypeGuidance                WorkflowUpdateParamsType = "GUIDANCE"
)

type WorkflowUpdateResponseEnvelope 

type WorkflowUpdateResponseEnvelope struct {
	// The updated workflow.
	Data Workflow `json:"data"`
	// JSON contains metadata for fields, check presence with [respjson.Field.Valid].
	JSON struct {
		Data        respjson.Field
		ExtraFields map[string]respjson.Field
		// contains filtered or unexported fields
	} `json:"-"`
}

func (WorkflowUpdateResponseEnvelope) RawJSON 

func (r WorkflowUpdateResponseEnvelope) RawJSON() string

Returns the unmodified JSON received from the API

func (*WorkflowUpdateResponseEnvelope) UnmarshalJSON 

func (r *WorkflowUpdateResponseEnvelope) UnmarshalJSON(data []byte) error

Source Files

View all Source files

Directories

Path Synopsis
apierror
apiform
apijson
apiquery
encoding/json
Package json implements encoding and decoding of JSON as defined in RFC 7159.
 Package json implements encoding and decoding of JSON as defined in RFC 7159.
encoding/json/sentinel
encoding/json/shims
This package provides shims over Go 1.2{2,3} APIs which are missing from Go 1.22, and used by the Go 1.24 encoding/json package.
 This package provides shims over Go 1.2{2,3} APIs which are missing from Go 1.22, and used by the Go 1.24 encoding/json package.
paramutil
requestconfig
testutil
packages
param
respjson
shared
constant

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.