--- title: Trigger a share deletion --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Resource Sharing](https://developers.cloudflare.com/api/go/resources/resource_sharing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Trigger a share deletion client.ResourceSharing.Delete(ctx, shareID, body) (\*[ResourceSharingDeleteResponse](), error) DELETE/accounts/{account\_id}/shares/{share\_id} Deletion is not immediate, an updated share object with a new status will be returned. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### ParametersExpand Collapse shareID string Share identifier tag. maxLength32 [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20delete%20%3E%20(params)%20default%20%3E%20(param)%20share_id%20%3E%20(schema)>)

body ResourceSharingDeleteParams

AccountID param.Field\[string] Account identifier. maxLength32 Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20delete%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type ResourceSharingDeleteResponse struct{…}

ID string Share identifier tag. maxLength32 Link to this property AccountID string Account identifier. maxLength32 Link to this property AccountName string The display name of an account. Link to this property Created Time When the share was created. formatdate-time Link to this property Modified Time When the share was modified. formatdate-time Link to this property Name string The name of the share. Link to this property OrganizationID string Organization identifier. maxLength32 Link to this property

Status ResourceSharingDeleteResponseStatus

One of the following: const ResourceSharingDeleteResponseStatusActive ResourceSharingDeleteResponseStatus = "active" Link to this property const ResourceSharingDeleteResponseStatusDeleting ResourceSharingDeleteResponseStatus = "deleting" Link to this property const ResourceSharingDeleteResponseStatusDeleted ResourceSharingDeleteResponseStatus = "deleted" Link to this property

Link to this property

TargetType ResourceSharingDeleteResponseTargetType

One of the following: const ResourceSharingDeleteResponseTargetTypeAccount ResourceSharingDeleteResponseTargetType = "account" Link to this property const ResourceSharingDeleteResponseTargetTypeOrganization ResourceSharingDeleteResponseTargetType = "organization" Link to this property

Link to this property AssociatedRecipientCount int64Optional The number of recipients in the ‘associated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property AssociatingRecipientCount int64Optional The number of recipients in the ‘associating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property DisassociatedRecipientCount int64Optional The number of recipients in the ‘disassociated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property DisassociatingRecipientCount int64Optional The number of recipients in the ‘disassociating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property

Kind ResourceSharingDeleteResponseKindOptional

One of the following: const ResourceSharingDeleteResponseKindSent ResourceSharingDeleteResponseKind = "sent" Link to this property const ResourceSharingDeleteResponseKindReceived ResourceSharingDeleteResponseKind = "received" Link to this property

Link to this property

Resources \[]ResourceSharingDeleteResponseResourceOptional A list of resources that are part of the share. This field is only included when requested via the ‘include\_resources’ parameter.

ID string Share Resource identifier. maxLength32 Link to this property Created Time When the share was created. formatdate-time Link to this property Meta unknown Resource Metadata. Link to this property Modified Time When the share was modified. formatdate-time Link to this property ResourceAccountID string Account identifier. maxLength32 Link to this property ResourceID string Share Resource identifier. maxLength32 Link to this property

ResourceType ResourceSharingDeleteResponseResourcesResourceType Resource Type.

One of the following: const ResourceSharingDeleteResponseResourcesResourceTypeCustomRuleset ResourceSharingDeleteResponseResourcesResourceType = "custom-ruleset" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeGatewayPolicy ResourceSharingDeleteResponseResourcesResourceType = "gateway-policy" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeGatewayDestinationIP ResourceSharingDeleteResponseResourcesResourceType = "gateway-destination-ip" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeGatewayBlockPageSettings ResourceSharingDeleteResponseResourcesResourceType = "gateway-block-page-settings" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeGatewayExtendedEmailMatching ResourceSharingDeleteResponseResourcesResourceType = "gateway-extended-email-matching" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeIdPFederationGrant ResourceSharingDeleteResponseResourcesResourceType = "idp-federation-grant" Link to this property const ResourceSharingDeleteResponseResourcesResourceTypeTrustGrant ResourceSharingDeleteResponseResourcesResourceType = "trust-grant" Link to this property

Link to this property ResourceVersion int64 Resource Version. Link to this property

Status ResourceSharingDeleteResponseResourcesStatus Resource Status.

One of the following: const ResourceSharingDeleteResponseResourcesStatusActive ResourceSharingDeleteResponseResourcesStatus = "active" Link to this property const ResourceSharingDeleteResponseResourcesStatusDeleting ResourceSharingDeleteResponseResourcesStatus = "deleting" Link to this property const ResourceSharingDeleteResponseResourcesStatusDeleted ResourceSharingDeleteResponseResourcesStatus = "deleted" Link to this property

Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(model)%20ResourceSharingDeleteResponse%20%3E%20(schema)>) ### Trigger a share deletion Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/resource_sharing" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) resourceSharing, err := client.ResourceSharing.Delete( context.TODO(), "3fd85f74b32742f1bff64a85009dda07", resource_sharing.ResourceSharingDeleteParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", resourceSharing.ID) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } } ```