Skip to content

Commit

Permalink
docs: correct delete_obj_default_permissions sig (#1483)
Browse files Browse the repository at this point in the history
Closes #1241

The docs were incorrect as to what arguments
delete_*_default_permissions accepted. This corrects the docs to show
that the methods accept an object and not an iterable of objects.

Co-authored-by: Jordan Woods <[email protected]>
  • Loading branch information
jorwoods and jorwoods authored Oct 11, 2024
1 parent 85e9682 commit 8bdaa67
Showing 1 changed file with 14 additions and 14 deletions.
28 changes: 14 additions & 14 deletions docs/api-ref.md
Original file line number Diff line number Diff line change
Expand Up @@ -2429,17 +2429,17 @@ Name | Description
TSC.Permission.Capability.Read: TSC.Permission.Mode.Allow
}

rules = TSC.PermissionsRule(
rule = TSC.PermissionsRule(
grantee=project_item,
capabilities=capabilities
)

server.projects.update_flow_default_permissions(project_item, [rules])
server.projects.update_flow_default_permissions(project_item, [rule])
```

#### projects.delete_workbook_default_permissions
```py
projects.delete_workbook_default_permissions(item, rules)
projects.delete_workbook_default_permissions(item, rule)
```

Delete default workbook permissions.
Expand All @@ -2451,7 +2451,7 @@ REST API: [Delete Default Workbook Permissions](https://help.tableau.com/current
Name | Description
:--- | :---
`item` | A project object.
`rules` | A list of PermissionsRule objects.
`rule` | A PermissionsRule object.

**Example**

Expand All @@ -2467,17 +2467,17 @@ Name | Description
TSC.Permission.Capability.ViewComments: TSC.Permission.Mode.Allow
}

rules = TSC.PermissionsRule(
rule = TSC.PermissionsRule(
grantee=project_item,
capabilities=capabilities
)

server.projects.delete_workbook_default_permissions(project_item, [rules])
server.projects.delete_workbook_default_permissions(project_item, rule)
```

#### projects.delete_datasource_default_permissions
```py
projects.delete_datasource_default_permissions(item, rules)
projects.delete_datasource_default_permissions(item, rule)
```

Delete default datasource permissions.
Expand All @@ -2489,7 +2489,7 @@ REST API: [Delete Default Datasource Permissions](https://help.tableau.com/curre
Name | Description
:--- | :---
`item` | A project object.
`rules` | A list of PermissionsRule objects.
`rule` | A PermissionsRule object.

**Example**

Expand All @@ -2505,17 +2505,17 @@ Name | Description
TSC.Permission.Capability.ExportXml: TSC.Permission.Mode.Allow
}

rules = TSC.PermissionsRule(
rule = TSC.PermissionsRule(
grantee=project_item,
capabilities=capabilities
)

server.projects.delete_datasource_default_permissions(project_item, [rules])
server.projects.delete_datasource_default_permissions(project_item, rule)
```

#### projects.delete_flow_default_permissions
```py
projects.delete_flow_default_permissions(item, rules)
projects.delete_flow_default_permissions(item, rule)
```

Delete default flow permissions.
Expand All @@ -2527,7 +2527,7 @@ REST API: [Delete Default Flow Permissions](https://help.tableau.com/current/api
Name | Description
:--- | :---
`item` | A project object.
`rules` | A list of PermissionsRule objects.
`rule` | A PermissionsRule object.

**Example**

Expand All @@ -2543,12 +2543,12 @@ Name | Description
TSC.Permission.Capability.Read: TSC.Permission.Mode.Allow
}

rules = TSC.PermissionsRule(
rule = TSC.PermissionsRule(
grantee=project_item,
capabilities=capabilities
)

server.projects.delete_flow_default_permissions(project_item, [rules])
server.projects.delete_flow_default_permissions(project_item, rule)
```

<br>
Expand Down

0 comments on commit 8bdaa67

Please sign in to comment.