@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api DataShareManagementClient
@base https://management.azure.com
@version 2019-11-01
@auth OAuth2
@common_fields {api-version: any # The api version to use.}
@endpoints 52
@hint download_for_search
@toc subscriptions(46), providers(6)

@group subscriptions
@endpoint GET /subscriptions/{subscriptionId}/providers/Microsoft.DataShare/accounts
@desc List Accounts in a subscription
@required {subscriptionId: any # The subscription identifier}
@optional {$skipToken: any # Continuation token}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}
@desc Get an account under a resource group
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}
@desc Create an account in the given resource group
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., account: map # The account payload.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}
@desc Delete an account
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account.}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint PATCH /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}
@desc Patch a given account
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., accountUpdateParameters: map # The account update parameters.}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts
@desc List Accounts in a resource group
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name.}
@optional {$skipToken: any # Continuation token}
@returns(200) Success

@endgroup

@group providers
@endpoint GET /providers/Microsoft.DataShare/listInvitations
@desc List the invitations
@optional {$skipToken: any # The continuation token}
@returns(200) Success

@endpoint GET /providers/Microsoft.DataShare/locations/{location}/consumerInvitations/{invitationId}
@desc Gets the invitation identified by invitationId
@required {location: any # Location of the invitation, invitationId: any # An invitation id}
@returns(200) Success

@endpoint POST /providers/Microsoft.DataShare/locations/{location}/rejectInvitation
@desc Rejects the invitation identified by invitationId
@required {location: any # Location of the invitation, invitation: map # An invitation payload}
@returns(200) Success

@endgroup

@group subscriptions
@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/dataSets/{dataSetName}
@desc Get DataSet in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., dataSetName: any # The name of the dataSet.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/dataSets/{dataSetName}
@desc Adds a new data set to an existing share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share to add the data set to., dataSetName: any # The name of the dataSet., dataSet: map # The new data set information.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/dataSets/{dataSetName}
@desc Delete DataSet in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., dataSetName: any # The name of the dataSet.}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/dataSets
@desc List DataSets in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@optional {$skipToken: any # continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/dataSetMappings/{dataSetMappingName}
@desc Get DataSetMapping in a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., dataSetMappingName: any # The name of the dataSetMapping.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/dataSetMappings/{dataSetMappingName}
@desc Maps a source data set in the source share to a sink data set in the share subscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription which will hold the data set sink., dataSetMappingName: any # The name of the data set mapping to be created., dataSetMapping: map # Destination data set configuration details.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/dataSetMappings/{dataSetMappingName}
@desc Delete DataSetMapping in a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., dataSetMappingName: any # The name of the dataSetMapping.}
@returns(200) Success
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/dataSetMappings
@desc List DataSetMappings in a share subscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription.}
@optional {$skipToken: any # Continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endgroup

@group providers
@endpoint POST /providers/Microsoft.DataShare/locations/{location}/activateEmail
@desc Activates the tenant and email combination using email code received.
@required {location: any # Location of the activation., emailRegistration: map # The payload for tenant domain activation.}
@returns(200) Success

@endpoint POST /providers/Microsoft.DataShare/locations/{location}/registerEmail
@desc Registers the tenant and email combination for verification.
@required {location: any # Location of the registration}
@returns(200) Success

@endgroup

@group subscriptions
@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}
@desc Get Invitation in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., invitationName: any # The name of the invitation.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}
@desc Sends a new invitation to a recipient to access a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share to send the invitation for., invitationName: any # The name of the invitation., invitation: map # Invitation details.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations/{invitationName}
@desc Delete Invitation in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., invitationName: any # The name of the invitation.}
@returns(200) Success
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations
@desc List all Invitations in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@optional {$skipToken: any # The continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endgroup

@group providers
@endpoint GET /providers/Microsoft.DataShare/operations
@desc Lists the available operations
@returns(200) Success

@endgroup

@group subscriptions
@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizationDetails
@desc List data set level details for a share synchronization
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., shareSynchronization: map # Share Synchronization payload.}
@optional {$skipToken: any # Continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/listSynchronizations
@desc List Synchronizations in a share
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@optional {$skipToken: any # Continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/reinstate
@desc Reinstate share subscription in a provider share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., providerShareSubscriptionId: any # To locate shareSubscription}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}/revoke
@desc Revoke share subscription in a provider share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., providerShareSubscriptionId: any # To locate shareSubscription}
@returns(200) Success
@returns(202) Accepted

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions/{providerShareSubscriptionId}
@desc Get share subscription in a provider share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., providerShareSubscriptionId: any # To locate shareSubscription}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/providerShareSubscriptions
@desc List of available share subscriptions to a provider share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@optional {$skipToken: any # Continuation Token}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}
@desc Get a specified share
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share to retrieve.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}
@desc Create a share in the given account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., share: map # The share payload}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}
@desc Deletes a share
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares
@desc List of available shares under an account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account.}
@optional {$skipToken: any # Continuation Token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/cancelSynchronization
@desc Request cancellation of a data share snapshot
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., shareSubscriptionSynchronization: map # Share Subscription Synchronization payload.}
@returns(200) Success
@returns(202) Accepted

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/consumerSourceDataSets
@desc Get source dataSets of a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription.}
@optional {$skipToken: any # Continuation token}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSourceShareSynchronizationSettings
@desc Get source share synchronization settings for a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription.}
@optional {$skipToken: any # Continuation token}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSynchronizationDetails
@desc List data set level details for a share subscription synchronization
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription., shareSubscriptionSynchronization: map # Share Subscription Synchronization payload.}
@optional {$skipToken: any # Continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/listSynchronizations
@desc List Synchronizations in a share subscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription.}
@optional {$skipToken: any # Continuation token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint POST /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/synchronize
@desc Initiate an asynchronous data share job
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of share subscription, synchronize: map # Synchronize payload}
@returns(200) Success
@returns(202) Accepted

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}
@desc Get shareSubscription in an account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}
@desc Create shareSubscription in an account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., shareSubscription: map # create parameters for shareSubscription}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}
@desc Delete shareSubscription in an account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription.}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions
@desc List of available share subscriptions under an account.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account.}
@optional {$skipToken: any # Continuation Token, $filter: any # Filters the results using OData syntax., $orderby: any # Sorts the results using OData syntax.}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/synchronizationSettings/{synchronizationSettingName}
@desc Get synchronizationSetting in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., synchronizationSettingName: any # The name of the synchronizationSetting.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/synchronizationSettings/{synchronizationSettingName}
@desc Adds a new synchronization setting to an existing share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share to add the synchronization setting to., synchronizationSettingName: any # The name of the synchronizationSetting., synchronizationSetting: map # The new synchronization setting information.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/synchronizationSettings/{synchronizationSettingName}
@desc Delete synchronizationSetting in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share., synchronizationSettingName: any # The name of the synchronizationSetting .}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/synchronizationSettings
@desc List synchronizationSettings in a share.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareName: any # The name of the share.}
@optional {$skipToken: any # continuation token}
@returns(200) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}
@desc Get Trigger in a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., triggerName: any # The name of the trigger.}
@returns(200) Success

@endpoint PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}
@desc This method creates a trigger for a share subscription
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription which will hold the data set sink., triggerName: any # The name of the trigger., trigger: map # Trigger details.}
@returns(200) Success
@returns(201) Success

@endpoint DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers/{triggerName}
@desc Delete Trigger in a shareSubscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the shareSubscription., triggerName: any # The name of the trigger.}
@returns(200) Success
@returns(202) Accepted
@returns(204) Success

@endpoint GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shareSubscriptions/{shareSubscriptionName}/triggers
@desc List Triggers in a share subscription.
@required {subscriptionId: any # The subscription identifier, resourceGroupName: any # The resource group name., accountName: any # The name of the share account., shareSubscriptionName: any # The name of the share subscription.}
@optional {$skipToken: any # Continuation token}
@returns(200) Success

@endgroup

@end