> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# grant_permission

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/grant_permission.rs#L24-L39)
pub async fn [grant\_permission](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/grant-permission.md#method.grant_permission)( \&self, principal: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), object: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), object\_type: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), permission: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GrantPermissionResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Grant user or role the specified permission on the specified objectGrant user or role the specified permission on the specified object.

##### Arguments

<ul>
  <li>`principal` - Name of the user or role for which the permission is being granted. Must be an existing user or role.</li>
  <li>`object` - Name of object permission is being granted to. It is recommended to use a fully-qualified name when possible.</li>
  <li>`object_type` - The type of object being granted to.</li>
  <li>`permission` - Permission being granted.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/grant_permission.rs#L55-L77)
pub async fn [grant\_permission\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/grant-permission.md#method.grant_permission_with_opts)( \&self, principal: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), object: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), object\_type: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), permission: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), options: [GrantPermissionRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GrantPermissionResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Grant user or role the specified permission on the specified objectGrant user or role the specified permission on the specified object.

##### Arguments

<ul>
  <li>`principal` - Name of the user or role for which the permission is being granted. Must be an existing user or role.</li>
  <li>`object` - Name of object permission is being granted to. It is recommended to use a fully-qualified name when possible.</li>
  <li>`object_type` - The type of object being granted to.</li>
  <li>`permission` - Permission being granted.</li>
  <li>`options` - The optional parameters; any left unset take the server’s defaults.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/grant_permission.rs#L80-L91)
pub async fn [grant\_permission\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/grant-permission.md#method.grant_permission_raw)( \&self, request: &[GrantPermissionRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GrantPermissionResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`GrantPermissionRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionRequest) to the `/grant/permission` endpoint.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/grant_permission.rs#L95-L107)
pub async fn [grant\_permission\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/grant-permission.md#method.grant_permission_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[GrantPermissionRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[GrantPermissionResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`GrantPermissionRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.GrantPermissionRequest) to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.