msgraph

Sep 21, 2026

Changes in this version

+ const ScopeChannelMessageReadAll

+ const ScopeChannelMessageSend

+ const ScopeChannelReadBasicAll

+ const ScopeChatMessageSend

+ const ScopeChatRead

+ const ScopeChatReadBasic

+ const ScopeChatReadWrite

+ const ScopePresenceRead

+ const ScopePresenceReadAll

+ const ScopeTeamReadBasicAll

type PreferDirective

+ const PreferIncludeUnknownEnumMembers

Sep 10, 2026

Changes in this version

+ const ScopeTasksRead

+ const ScopeTasksReadWrite

Sep 10, 2026

Changes in this version

+ func ScopeSatisfies(granted []string, required string) bool

Sep 10, 2026

Changes in this version

+ const ScopeMailboxSettingsRead

+ const ScopeMailboxSettingsReadWrite

Sep 10, 2026

Changes in this version

+ const MaxBatchRequests

type APIError

+ func ErrorFromBatch(response BatchResponse) *APIError

Sep 10, 2026

Changes in this version

+ const DefaultMaxPages

+ var ErrResponseTooLarge = errors.New("msgraph: response body too large")

type Option

+ func WithMaxResponseBytes(limit int64) Option

Sep 10, 2026

Changes in this version

+ func ContainsRaw(filter Expr) bool

+ func FieldsOf(filter Expr) []string

Aug 18, 2026

Changes in this version

+ var ErrInvalidParams = errors.New("msgraph: invalid query parameters")

+ var ErrNotModified = errors.New("msgraph: not modified")

+ var ErrUntrustedHost = errors.New("msgraph: untrusted request host")

+ func Collect[T any](ctx context.Context, client *Client, path string, params Params, ...) ([]T, error)

+ func Delta[T any](ctx context.Context, client *Client, path string, params Params, ...) (items []T, deltaLink string, err error)

+ func Field(segments ...string) string

+ func First[T any](ctx context.Context, client *Client, path string, params Params) (value T, found bool, err error)

+ func HasCode(err error, code string) bool

+ func IsConflict(err error) bool

+ func IsNotModified(err error) bool

+ func IsPreconditionFailed(err error) bool

+ func LiteralOf[T Literal](value T) string

type APIError

+ Details []ErrorDetail

+ RetryAfter time.Duration

+ Target string

+ type ConsistencyLevel string

+ type ErrorDetail struct

+ Code string

+ Message string

+ Target string

+ type Expr interface

+ ODataFilter func() string

+ func All(collection, variable string, predicate Expr) Expr

+ func And(operands ...Expr) Expr

+ func Any(collection, variable string, predicate Expr) Expr

+ func Contains(field, value string) Expr

+ func EndsWith(field, value string) Expr

+ func Eq[T Literal](field string, value T) Expr

+ func Ge[T Literal](field string, value T) Expr

+ func Gt[T Literal](field string, value T) Expr

+ func In[T Literal](field string, values ...T) Expr

+ func IsNotNull(field string) Expr

+ func IsNull(field string) Expr

+ func Le[T Literal](field string, value T) Expr

+ func Lt[T Literal](field string, value T) Expr

+ func Ne[T Literal](field string, value T) Expr

+ func Not(operand Expr) Expr

+ func Or(operands ...Expr) Expr

+ func Raw(filter string) Expr

+ func StartsWith(field, value string) Expr

+ type Literal interface

type Option

+ func WithAllowedHosts(hosts ...string) Option

+ type Order struct

+ Descending bool

+ Field string

+ func Asc(field string) Order

+ func Desc(field string) Order

+ func (o Order) String() string

type Page

+ Count *int64

+ DeltaLink string

type Params

+ Count bool

+ SkipToken string

+ Sort []Order

+ Where Expr

+ func (p Params) Validate() error

+ type PreferDirective string

+ const PreferReturnMinimal

+ const PreferReturnRepresentation

+ func MaxPageSizePreference(size int) PreferDirective

+ func TimeZonePreference(timeZone string) PreferDirective

type Request

+ IfMatch string

+ IfNoneMatch string

type Response

+ ETag string

+ func Delete(ctx context.Context, client *Client, path string, params Params) (*Response, error)

+ func Do[T any](ctx context.Context, client *Client, req Request) (T, *Response, error)

+ func Get[T any](ctx context.Context, client *Client, path string, params Params) (T, *Response, error)

+ func Patch[T any](ctx context.Context, client *Client, path string, params Params, body any) (T, *Response, error)

+ func PostNoContent(ctx context.Context, client *Client, path string, params Params, body any) (*Response, error)

+ func Post[T any](ctx context.Context, client *Client, path string, params Params, body any) (T, *Response, error)

Aug 2, 2026

Changes in this version

+ const ScopeCalendarsRead

+ const ScopeCalendarsReadWrite

+ const ScopeContactsRead

+ const ScopeContactsReadWrite

+ const ScopeDirectoryReadAll

+ const ScopeFilesRead

+ const ScopeFilesReadWrite

+ const ScopeGroupReadAll

+ const ScopeGroupReadWriteAll

+ const ScopeMailRead

+ const ScopeMailReadWrite

+ const ScopeMailSend

+ const ScopeUserRead

+ const ScopeUserReadBasicAll

+ const ScopeUserReadWriteAll

+ func MergeScopes(values ...[]string) []string

type Client

+ func (c *Client) TranslateExchangeIDs(ctx context.Context, user string, inputIDs []string, ...) ([]TranslatedExchangeID, *Response, error)

+ type ExchangeIDFormat string

+ const ExchangeIDFormatEWSID

+ const ExchangeIDFormatEntryID

+ const ExchangeIDFormatImmutableEntryID

+ const ExchangeIDFormatRESTID

+ const ExchangeIDFormatRESTImmutableEntryID

+ type PermissionSuggestion struct

+ Match string

+ Method string

+ Notes []string

+ Path string

+ Scopes []string

+ func SuggestDelegatedScopes(method, rawPath string) PermissionSuggestion

+ type TranslateExchangeIDsRequest struct

+ InputIDs []string

+ SourceIDType ExchangeIDFormat

+ TargetIDType ExchangeIDFormat

+ type TranslateExchangeIDsResponse struct

+ Value []TranslatedExchangeID

+ type TranslatedExchangeID struct

+ SourceID string

+ TargetID string

Aug 2, 2026

Changes in this version

+ const ConsistencyLevelEventual

+ const GraphCLIClientID

+ const GraphResourceAppID

+ const MailReadDelegatedID

+ const MailReadWriteDelegatedID

+ const MailSendDelegatedID

+ const PreferBodyContentTypeHTML

+ const PreferBodyContentTypeText

+ const PreferIDTypeImmutableID

+ const UserReadDelegatedID

+ var CommonPermissions = []Permission

+ var ErrMaxPagesExceeded = errors.New("msgraph: max pages exceeded")

+ var ErrPageCycle = errors.New("msgraph: repeated nextLink")

+ var ErrRequestFailed = errors.New("msgraph: request failed")

+ func BodyContentTypePreference(contentType string) string

+ func IsForbidden(err error) bool

+ func IsNotFound(err error) bool

+ func IsStatus(err error, statusCode int) bool

+ func IsThrottled(err error) bool

+ func IsUnauthorized(err error) bool

+ func Items[T any](ctx context.Context, client *Client, path string, params Params, ...) iter.Seq2[T, error]

+ func Pages[T any](ctx context.Context, client *Client, path string, params Params, ...) iter.Seq2[Page[T], error]

+ type APIError struct

+ Code string

+ Message string

+ Raw []byte

+ RequestID string

+ StatusCode int

+ func (e *APIError) Error() string

+ func (e *APIError) Unwrap() error

+ type BatchError struct

+ Responses []BatchResponse

+ func (e *BatchError) Error() string

+ type BatchRequest struct

+ Body any

+ Headers map[string]string

+ ID string

+ Method string

+ URL string

+ type BatchResponse struct

+ Body json.RawMessage

+ Headers map[string]string

+ ID string

+ Status int

+ func FailedBatchResponses(responses []BatchResponse) []BatchResponse

+ type Client struct

+ func New(token TokenSource, opts ...Option) (*Client, error)

+ func (c *Client) Batch(ctx context.Context, requests []BatchRequest) ([]BatchResponse, error)

+ func (c *Client) BatchStrict(ctx context.Context, requests []BatchRequest) ([]BatchResponse, error)

+ func (c *Client) Delete(ctx context.Context, path string, params Params, out any) (*Response, error)

+ func (c *Client) Do(ctx context.Context, req Request, out any) (*Response, error)

+ func (c *Client) Get(ctx context.Context, path string, params Params, out any) (*Response, error)

+ func (c *Client) Patch(ctx context.Context, path string, params Params, body, out any) (*Response, error)

+ func (c *Client) Post(ctx context.Context, path string, params Params, body, out any) (*Response, error)

+ type Option func(*Client) error

+ func WithBaseURL(value string) Option

+ func WithHTTPClient(client *http.Client) Option

+ func WithMaxRetries(value int) Option

+ func WithMaxRetryDelay(value time.Duration) Option

+ func WithRetryUnsafeMethods(value bool) Option

+ func WithSleeper(fn sleepFunc) Option

+ func WithUserAgent(value string) Option

+ type Page struct

+ NextLink string

+ Value []T

+ type PageOption func(*pageConfig)

+ func WithMaxPages(maxPages int) PageOption

+ type Params struct

+ Custom url.Values

+ Expand []string

+ Filter string

+ OrderBy []string

+ Search string

+ Select []string

+ Skip int

+ Top int

+ func (p Params) Values() url.Values

+ type Permission struct

+ AdminConsentRequired bool

+ ID string

+ Kind string

+ Name string

+ PersonalAccountsAllowed bool

+ func FindPermission(nameOrID string) (Permission, bool)

+ type Request struct

+ Body any

+ ConsistencyLevel string

+ ContentType string

+ Header http.Header

+ Method string

+ Params Params

+ Prefer []string

+ Query url.Values

+ RawBody []byte

+ URL string

+ type Response struct

+ Header http.Header

+ RequestID string

+ StatusCode int

+ type TokenSource interface

+ Token func(ctx context.Context) (string, error)

+ type TokenSourceFunc func(ctx context.Context) (string, error)

+ func (fn TokenSourceFunc) Token(ctx context.Context) (string, error)