Interface IOrganizations
- Namespace
- Meraki.Api.Interfaces.General.Organizations
- Assembly
- Meraki.Api.dll
Represents a collection of functions to interact with the API endpoints
public interface IOrganizations
- Extension Methods
Methods
ClaimIntoOrganizationAsync(string, OrganizationClaimRequest, CancellationToken)
Claim a list of devices, licenses, and/or orders into an organization inventory
[Post("/organizations/{organizationId}/claim")]
[Obsolete("Use ClaimIntoOrganizationInventoryAsync")]
Task<OrganizationClaimResponse> ClaimIntoOrganizationAsync(string organizationId, OrganizationClaimRequest organizationClaimRequest, CancellationToken cancellationToken = default)
Parameters
organizationId
stringThe organization id
organizationClaimRequest
OrganizationClaimRequestBody for making a claim request
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
CloneOrganizationAsync(string, CloneOrganization, CancellationToken)
Create a new organization by cloning the addressed organization
[Post("/organizations/{organizationId}/clone")]
Task<Organization> CloneOrganizationAsync(string organizationId, CloneOrganization cloneOrganization, CancellationToken cancellationToken = default)
Parameters
organizationId
stringThe organization id
cloneOrganization
CloneOrganizationBody for cloning an organization
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
CreateOrganizationAsync(OrganizationCreateRequest, CancellationToken)
Create a new organization
[Post("/organizations")]
Task<Organization> CreateOrganizationAsync(OrganizationCreateRequest createOrganization, CancellationToken cancellationToken = default)
Parameters
createOrganization
OrganizationCreateRequestBody for creating an organization
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
DeleteOrganizationAsync(string, CancellationToken)
Delete an organization
[Delete("/organizations/{organizationId}")]
Task DeleteOrganizationAsync(string organizationId, CancellationToken cancellationToken = default)
Parameters
organizationId
stringThe organization id
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
GetOrganizationAsync(string, CancellationToken)
Return an organization
[Get("/organizations/{organizationId}")]
Task<Organization> GetOrganizationAsync(string organizationId, CancellationToken cancellationToken = default)
Parameters
organizationId
stringThe organization id
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
GetOrganizationsAsync(int?, string?, string?, CancellationToken)
List the organizations that the user has privileges on
[Get("/organizations")]
Task<List<Organization>> GetOrganizationsAsync(int? perPage = 9000, string? startingAfter = null, string? endingBefore = null, CancellationToken cancellationToken = default)
Parameters
perPage
int?The number of entries per page returned. Acceptable range is 3 - 9000. Default is 9000.
startingAfter
stringA token used by the server to indicate the start of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
endingBefore
stringA token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call
UpdateOrganizationAsync(string, OrganizationUpdateRequest, CancellationToken)
Update an organization
[Put("/organizations/{organizationId}")]
Task<Organization> UpdateOrganizationAsync(string organizationId, OrganizationUpdateRequest updateOrganization, CancellationToken cancellationToken = default)
Parameters
organizationId
stringThe organization id
updateOrganization
OrganizationUpdateRequestBody for updating an organization
cancellationToken
CancellationToken
Returns
Exceptions
- ApiException
Thrown when fails to make API call