CaseShare

Represents a sharing entry on a Case.

You can only create, edit, and delete sharing entries for standard objects whose RowCause field is set to Manual. Sharing entries for standard objects with different RowCause values are created as a result of your Salesforce org’s sharing configuration and are read-only. For some sharing mechanisms, such as sharing sets, sharing entries aren’t stored at all.

While Salesforce currently maintains read-only sharing entries for multiple sharing mechanisms, it’s possible that we’ll stop storing certain share records to improve performance. As a best practice, don’t create customizations that rely on the availability of these sharing entries. Any changes to sharing behavior will be communicated before they occur.

Introduced in API version 3.0.

describeSObjects(), create(), delete(), query(), retrieve(), update(), upsert()

  • As of Summer ’20 and later, only users with access to the Case object can access this object.

  • Type: picklist

  • Properties: Create, Filter, Group, Restricted picklist, Sort, Update

  • Description:

    Level of access that the User or Group has to the Case.

    This field must be set to an access level that is higher than the organization’s default access level for cases.

  • Possible values:

    • Read — Read
    • Edit — Edit
    • All — All

  • Type: reference

  • Properties: Create, Filter, Group, Sort

  • Description:

    ID of the Case associated with this sharing entry. This field can’t be updated.

    This is a relationship field.

  • Relationship name: Case

  • Relationship type: relationship

  • Refers to: Case

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort

  • Description:

    Reason that this sharing entry exists. If you’re creating a sharing entry, the only permitted value is Manual. If no value is specified, the field defaults to Manual. All other RowCause values are read-only. After the sharing entry is created, this field can’t be edited.

    Valid values include:

  • Possible values:

    • Manual — Manual — The User or Group has access because a user with “All” access manually shared the Case with them.
    • Owner — Owner — The User is the owner of the Case.
    • ImplicitChild — ImplicitChild — The User or Group has access to the Case on the Account associated with this Case. After faster account sharing recalculation is enabled for your org, sharing entries with this value aren’t returned in queries. Instead of storing implicit child shares, record access is determined dynamically.
    • RelatedPortalUser — RelatedPortalUser — The portal user is the contact on the Case.
    • Rule — Rule — The User or Group has access via a Case sharing rule.
    • GuestRule — GuestRule — The User or Group has access via a Case guest user sharing rule.
    • Team — Team — The User or Group has team access.
    • LpuImplicit — LpuImplicit — The User has access to records owned by high-volume Experience Cloud site users via a share group.
    • ARImplicit — ARImplicit — The User, who belongs to a partner or customer account, has access to the Case via an account relationship data sharing rule.

  • Type: reference

  • Properties: Create, Filter, Group, Sort

  • Description:

    ID of the User or Group that has been given access to the Case. This field can’t be updated.

    This is a polymorphic relationship field.

  • Relationship name: UserOrGroup

  • Relationship type: polymorphic

  • Refers to: Group, User

This object allows you to determine which users and groups can view and edit Case records owned by other users. If you attempt to create a record that matches an existing record, request updates any modified fields and returns the existing record.

After faster account sharing recalculation is enabled for your org, we no longer store implicit share records between accounts and their child case records. Sharing entries that have a value of ImplicitChild in the RowCause field aren’t returned when you query this object. Instead, the system dynamically determines whether users can access child case records when they try to access them. This change speeds up ownership and sharing recalculation for accounts.

For more information, see the Faster Account Sharing Recalculation knowledge article.