llama-cloud 0.1.21__tar.gz → 0.1.23__tar.gz

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.1
 Name: llama-cloud
-Version: 0.1.21
+Version: 0.1.23
 Summary: 
 License: MIT
 Author: Logan Markewich
@@ -13,7 +13,6 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
 Requires-Dist: certifi (>=2024.7.4)
 Requires-Dist: httpx (>=0.20.0)
 Requires-Dist: pydantic (>=1.10)

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/__init__.py

@@ -60,23 +60,21 @@ from .types import (
     CompositeRetrievedTextNodeWithScore,
     ConfigurableDataSinkNames,
     ConfigurableDataSourceNames,
-    ConfigurableTransformationDefinition,
-    ConfigurableTransformationNames,
     CreditType,
     DataSink,
     DataSinkComponent,
     DataSinkCreate,
     DataSinkCreateComponent,
-    DataSinkDefinition,
     DataSource,
     DataSourceComponent,
     DataSourceCreate,
     DataSourceCreateComponent,
     DataSourceCreateCustomMetadataValue,
     DataSourceCustomMetadataValue,
-    DataSourceDefinition,
     DataSourceUpdateDispatcherConfig,
     DeleteParams,
+    DocumentBlock,
+    DocumentChunkMode,
     DocumentIngestionJobParams,
     EditSuggestion,
     EditSuggestionBlocksItem,
@@ -108,6 +106,7 @@ from .types import (
     ExtractJobCreateDataSchemaOverride,
     ExtractJobCreateDataSchemaOverrideZeroValue,
     ExtractMode,
+    ExtractModels,
     ExtractResultset,
     ExtractResultsetData,
     ExtractResultsetDataItemValue,
@@ -161,10 +160,14 @@ from .types import (
     LlamaIndexCoreBaseLlmsTypesChatMessage,
     LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem,
     LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Audio,
+    LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Document,
     LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Image,
     LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Text,
     LlamaParseParameters,
     LlamaParseSupportedFileExtensions,
+    LlmConfigResult,
+    LlmConfigResultLlmType,
+    LlmConfigsResponse,
     LlmModelData,
     LlmParameters,
     LoadFilesJobConfig,
@@ -256,6 +259,7 @@ from .types import (
     Pooling,
     PresetCompositeRetrievalParams,
     PresetRetrievalParams,
+    PresetRetrievalParamsSearchFiltersInferenceSchemaValue,
     PresignedUrl,
     ProgressEvent,
     ProgressEventStatus,
@@ -304,7 +308,6 @@ from .types import (
     TextNodeRelationshipsValue,
     TextNodeWithScore,
     TokenChunkingConfig,
-    TransformationCategoryNames,
     UsageAndPlan,
     UsageMetricResponse,
     UsageResponse,
@@ -354,10 +357,11 @@ from .resources import (
     PipelineUpdateEmbeddingConfig_OpenaiEmbedding,
     PipelineUpdateEmbeddingConfig_VertexaiEmbedding,
     PipelineUpdateTransformConfig,
+    RetrievalParamsSearchFiltersInferenceSchemaValue,
     UpdateReportPlanApiV1ReportsReportIdPlanPatchRequestAction,
+    admin,
     beta,
     chat_apps,
-    component_definitions,
     data_sinks,
     data_sources,
     embedding_model_configs,
@@ -434,14 +438,11 @@ __all__ = [
     "CompositeRetrievedTextNodeWithScore",
     "ConfigurableDataSinkNames",
     "ConfigurableDataSourceNames",
-    "ConfigurableTransformationDefinition",
-    "ConfigurableTransformationNames",
     "CreditType",
     "DataSink",
     "DataSinkComponent",
     "DataSinkCreate",
     "DataSinkCreateComponent",
-    "DataSinkDefinition",
     "DataSinkUpdateComponent",
     "DataSource",
     "DataSourceComponent",
@@ -449,11 +450,12 @@ __all__ = [
     "DataSourceCreateComponent",
     "DataSourceCreateCustomMetadataValue",
     "DataSourceCustomMetadataValue",
-    "DataSourceDefinition",
     "DataSourceUpdateComponent",
     "DataSourceUpdateCustomMetadataValue",
     "DataSourceUpdateDispatcherConfig",
     "DeleteParams",
+    "DocumentBlock",
+    "DocumentChunkMode",
     "DocumentIngestionJobParams",
     "EditSuggestion",
     "EditSuggestionBlocksItem",
@@ -499,6 +501,7 @@ __all__ = [
     "ExtractJobCreateDataSchemaOverride",
     "ExtractJobCreateDataSchemaOverrideZeroValue",
     "ExtractMode",
+    "ExtractModels",
     "ExtractResultset",
     "ExtractResultsetData",
     "ExtractResultsetDataItemValue",
@@ -558,10 +561,14 @@ __all__ = [
     "LlamaIndexCoreBaseLlmsTypesChatMessage",
     "LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem",
     "LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Audio",
+    "LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Document",
     "LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Image",
     "LlamaIndexCoreBaseLlmsTypesChatMessageBlocksItem_Text",
     "LlamaParseParameters",
     "LlamaParseSupportedFileExtensions",
+    "LlmConfigResult",
+    "LlmConfigResultLlmType",
+    "LlmConfigsResponse",
     "LlmModelData",
     "LlmParameters",
     "LoadFilesJobConfig",
@@ -663,6 +670,7 @@ __all__ = [
     "Pooling",
     "PresetCompositeRetrievalParams",
     "PresetRetrievalParams",
+    "PresetRetrievalParamsSearchFiltersInferenceSchemaValue",
     "PresignedUrl",
     "ProgressEvent",
     "ProgressEventStatus",
@@ -693,6 +701,7 @@ __all__ = [
     "ReportStateEvent",
     "ReportUpdateEvent",
     "RetrievalMode",
+    "RetrievalParamsSearchFiltersInferenceSchemaValue",
     "RetrieveResults",
     "Retriever",
     "RetrieverCreate",
@@ -711,7 +720,6 @@ __all__ = [
     "TextNodeRelationshipsValue",
     "TextNodeWithScore",
     "TokenChunkingConfig",
-    "TransformationCategoryNames",
     "UnprocessableEntityError",
     "UpdateReportPlanApiV1ReportsReportIdPlanPatchRequestAction",
     "UsageAndPlan",
@@ -728,9 +736,9 @@ __all__ = [
     "VertexAiEmbeddingConfig",
     "VertexEmbeddingMode",
     "VertexTextEmbedding",
+    "admin",
     "beta",
     "chat_apps",
-    "component_definitions",
     "data_sinks",
     "data_sources",
     "embedding_model_configs",

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/client.py

@@ -6,9 +6,9 @@ import httpx
 
 from .core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from .environment import LlamaCloudEnvironment
+from .resources.admin.client import AdminClient, AsyncAdminClient
 from .resources.beta.client import AsyncBetaClient, BetaClient
 from .resources.chat_apps.client import AsyncChatAppsClient, ChatAppsClient
-from .resources.component_definitions.client import AsyncComponentDefinitionsClient, ComponentDefinitionsClient
 from .resources.data_sinks.client import AsyncDataSinksClient, DataSinksClient
 from .resources.data_sources.client import AsyncDataSourcesClient, DataSourcesClient
 from .resources.embedding_model_configs.client import AsyncEmbeddingModelConfigsClient, EmbeddingModelConfigsClient
@@ -50,8 +50,8 @@ class LlamaCloud:
         self.jobs = JobsClient(client_wrapper=self._client_wrapper)
         self.evals = EvalsClient(client_wrapper=self._client_wrapper)
         self.parsing = ParsingClient(client_wrapper=self._client_wrapper)
-        self.component_definitions = ComponentDefinitionsClient(client_wrapper=self._client_wrapper)
         self.chat_apps = ChatAppsClient(client_wrapper=self._client_wrapper)
+        self.admin = AdminClient(client_wrapper=self._client_wrapper)
         self.llama_extract = LlamaExtractClient(client_wrapper=self._client_wrapper)
         self.reports = ReportsClient(client_wrapper=self._client_wrapper)
         self.beta = BetaClient(client_wrapper=self._client_wrapper)
@@ -83,8 +83,8 @@ class AsyncLlamaCloud:
         self.jobs = AsyncJobsClient(client_wrapper=self._client_wrapper)
         self.evals = AsyncEvalsClient(client_wrapper=self._client_wrapper)
         self.parsing = AsyncParsingClient(client_wrapper=self._client_wrapper)
-        self.component_definitions = AsyncComponentDefinitionsClient(client_wrapper=self._client_wrapper)
         self.chat_apps = AsyncChatAppsClient(client_wrapper=self._client_wrapper)
+        self.admin = AsyncAdminClient(client_wrapper=self._client_wrapper)
         self.llama_extract = AsyncLlamaExtractClient(client_wrapper=self._client_wrapper)
         self.reports = AsyncReportsClient(client_wrapper=self._client_wrapper)
         self.beta = AsyncBetaClient(client_wrapper=self._client_wrapper)

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/resources/__init__.py

@@ -1,9 +1,9 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from . import (
+    admin,
     beta,
     chat_apps,
-    component_definitions,
     data_sinks,
     data_sources,
     embedding_model_configs,
@@ -52,6 +52,7 @@ from .pipelines import (
     PipelineUpdateEmbeddingConfig_OpenaiEmbedding,
     PipelineUpdateEmbeddingConfig_VertexaiEmbedding,
     PipelineUpdateTransformConfig,
+    RetrievalParamsSearchFiltersInferenceSchemaValue,
 )
 from .reports import UpdateReportPlanApiV1ReportsReportIdPlanPatchRequestAction
 
@@ -88,10 +89,11 @@ __all__ = [
     "PipelineUpdateEmbeddingConfig_OpenaiEmbedding",
     "PipelineUpdateEmbeddingConfig_VertexaiEmbedding",
     "PipelineUpdateTransformConfig",
+    "RetrievalParamsSearchFiltersInferenceSchemaValue",
     "UpdateReportPlanApiV1ReportsReportIdPlanPatchRequestAction",
+    "admin",
     "beta",
     "chat_apps",
-    "component_definitions",
     "data_sinks",
     "data_sources",
     "embedding_model_configs",

llama_cloud-0.1.23/llama_cloud/resources/admin/client.py

@@ -0,0 +1,78 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import urllib.parse
+from json.decoder import JSONDecodeError
+
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...errors.unprocessable_entity_error import UnprocessableEntityError
+from ...types.http_validation_error import HttpValidationError
+from ...types.llm_configs_response import LlmConfigsResponse
+
+try:
+    import pydantic
+    if pydantic.__version__.startswith("1."):
+        raise ImportError
+    import pydantic.v1 as pydantic  # type: ignore
+except ImportError:
+    import pydantic  # type: ignore
+
+
+class AdminClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def get_llm_configs(self) -> LlmConfigsResponse:
+        """
+        from llama_cloud.client import LlamaCloud
+
+        client = LlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        client.admin.get_llm_configs()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/admin/llm-configs"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(LlmConfigsResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncAdminClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def get_llm_configs(self) -> LlmConfigsResponse:
+        """
+        from llama_cloud.client import AsyncLlamaCloud
+
+        client = AsyncLlamaCloud(
+            token="YOUR_TOKEN",
+        )
+        await client.admin.get_llm_configs()
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "GET",
+            urllib.parse.urljoin(f"{self._client_wrapper.get_base_url()}/", "api/v1/admin/llm-configs"),
+            headers=self._client_wrapper.get_headers(),
+            timeout=60,
+        )
+        if 200 <= _response.status_code < 300:
+            return pydantic.parse_obj_as(LlmConfigsResponse, _response.json())  # type: ignore
+        if _response.status_code == 422:
+            raise UnprocessableEntityError(pydantic.parse_obj_as(HttpValidationError, _response.json()))  # type: ignore
+        try:
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/resources/jobs/client.py

@@ -37,6 +37,10 @@ class JobsClient:
         """
         Get jobs for a project.
 
+        Note:
+        The include_usage_metrics parameter is deprecated and will be removed in a future version.
+        We've moved to usage v2 and this parameter will no longer return meaningful data.
+
         Parameters:
             - job_name: typing.Optional[str].
 
@@ -44,7 +48,7 @@ class JobsClient:
 
             - offset: typing.Optional[int].
 
-            - include_usage_metrics: typing.Optional[bool].
+            - include_usage_metrics: typing.Optional[bool]. Deprecated: This parameter is no longer supported as we've moved to usage v2. It will be removed in a future version.
 
             - project_id: typing.Optional[str].
 
@@ -101,6 +105,10 @@ class AsyncJobsClient:
         """
         Get jobs for a project.
 
+        Note:
+        The include_usage_metrics parameter is deprecated and will be removed in a future version.
+        We've moved to usage v2 and this parameter will no longer return meaningful data.
+
         Parameters:
             - job_name: typing.Optional[str].
 
@@ -108,7 +116,7 @@ class AsyncJobsClient:
 
             - offset: typing.Optional[int].
 
-            - include_usage_metrics: typing.Optional[bool].
+            - include_usage_metrics: typing.Optional[bool]. Deprecated: This parameter is no longer supported as we've moved to usage v2. It will be removed in a future version.
 
             - project_id: typing.Optional[str].
 

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/resources/llama_extract/client.py

@@ -92,7 +92,12 @@ class LlamaExtractClient:
 
             - config: ExtractConfig. The configuration parameters for the extraction agent.
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import LlamaCloud
 
         client = LlamaCloud(
@@ -103,6 +108,7 @@ class LlamaExtractClient:
             config=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """
@@ -238,7 +244,12 @@ class LlamaExtractClient:
 
             - config: ExtractConfig. The configuration parameters for the extraction agent.
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import LlamaCloud
 
         client = LlamaCloud(
@@ -249,6 +260,7 @@ class LlamaExtractClient:
             config=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """
@@ -342,6 +354,7 @@ class LlamaExtractClient:
             - request: ExtractJobCreate.
         ---
         from llama_cloud import (
+            DocumentChunkMode,
             ExtractConfig,
             ExtractJobCreate,
             ExtractMode,
@@ -359,6 +372,7 @@ class LlamaExtractClient:
                 config_override=ExtractConfig(
                     extraction_target=ExtractTarget.PER_DOC,
                     extraction_mode=ExtractMode.FAST,
+                    chunk_mode=DocumentChunkMode.PAGE,
                 ),
             ),
         )
@@ -428,6 +442,7 @@ class LlamaExtractClient:
         ---
         from llama_cloud import (
             ChunkMode,
+            DocumentChunkMode,
             ExtractConfig,
             ExtractJobCreate,
             ExtractMode,
@@ -449,6 +464,7 @@ class LlamaExtractClient:
                 config_override=ExtractConfig(
                     extraction_target=ExtractTarget.PER_DOC,
                     extraction_mode=ExtractMode.FAST,
+                    chunk_mode=DocumentChunkMode.PAGE,
                 ),
             ),
             extract_settings=LlamaExtractSettings(
@@ -548,7 +564,12 @@ class LlamaExtractClient:
 
             - config_override: typing.Optional[ExtractConfig].
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import LlamaCloud
 
         client = LlamaCloud(
@@ -560,6 +581,7 @@ class LlamaExtractClient:
             config_override=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """
@@ -831,7 +853,12 @@ class AsyncLlamaExtractClient:
 
             - config: ExtractConfig. The configuration parameters for the extraction agent.
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import AsyncLlamaCloud
 
         client = AsyncLlamaCloud(
@@ -842,6 +869,7 @@ class AsyncLlamaExtractClient:
             config=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """
@@ -977,7 +1005,12 @@ class AsyncLlamaExtractClient:
 
             - config: ExtractConfig. The configuration parameters for the extraction agent.
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import AsyncLlamaCloud
 
         client = AsyncLlamaCloud(
@@ -988,6 +1021,7 @@ class AsyncLlamaExtractClient:
             config=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """
@@ -1081,6 +1115,7 @@ class AsyncLlamaExtractClient:
             - request: ExtractJobCreate.
         ---
         from llama_cloud import (
+            DocumentChunkMode,
             ExtractConfig,
             ExtractJobCreate,
             ExtractMode,
@@ -1098,6 +1133,7 @@ class AsyncLlamaExtractClient:
                 config_override=ExtractConfig(
                     extraction_target=ExtractTarget.PER_DOC,
                     extraction_mode=ExtractMode.FAST,
+                    chunk_mode=DocumentChunkMode.PAGE,
                 ),
             ),
         )
@@ -1167,6 +1203,7 @@ class AsyncLlamaExtractClient:
         ---
         from llama_cloud import (
             ChunkMode,
+            DocumentChunkMode,
             ExtractConfig,
             ExtractJobCreate,
             ExtractMode,
@@ -1188,6 +1225,7 @@ class AsyncLlamaExtractClient:
                 config_override=ExtractConfig(
                     extraction_target=ExtractTarget.PER_DOC,
                     extraction_mode=ExtractMode.FAST,
+                    chunk_mode=DocumentChunkMode.PAGE,
                 ),
             ),
             extract_settings=LlamaExtractSettings(
@@ -1287,7 +1325,12 @@ class AsyncLlamaExtractClient:
 
             - config_override: typing.Optional[ExtractConfig].
         ---
-        from llama_cloud import ExtractConfig, ExtractMode, ExtractTarget
+        from llama_cloud import (
+            DocumentChunkMode,
+            ExtractConfig,
+            ExtractMode,
+            ExtractTarget,
+        )
         from llama_cloud.client import AsyncLlamaCloud
 
         client = AsyncLlamaCloud(
@@ -1299,6 +1342,7 @@ class AsyncLlamaExtractClient:
             config_override=ExtractConfig(
                 extraction_target=ExtractTarget.PER_DOC,
                 extraction_mode=ExtractMode.FAST,
+                chunk_mode=DocumentChunkMode.PAGE,
             ),
         )
         """

{llama_cloud-0.1.21 → llama_cloud-0.1.23}/llama_cloud/resources/organizations/client.py

@@ -520,12 +520,16 @@ class OrganizationsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def get_user_role(self, organization_id: str) -> typing.Optional[UserOrganizationRole]:
+    def get_user_role(
+        self, organization_id: str, *, project_id: typing.Optional[str] = None
+    ) -> typing.Optional[UserOrganizationRole]:
         """
         Get the role of a user in an organization.
 
         Parameters:
             - organization_id: str.
+
+            - project_id: typing.Optional[str].
         ---
         from llama_cloud.client import LlamaCloud
 
@@ -541,6 +545,7 @@ class OrganizationsClient:
             urllib.parse.urljoin(
                 f"{self._client_wrapper.get_base_url()}/", f"api/v1/organizations/{organization_id}/users/roles"
             ),
+            params=remove_none_from_dict({"project_id": project_id}),
             headers=self._client_wrapper.get_headers(),
             timeout=60,
         )
@@ -1216,12 +1221,16 @@ class AsyncOrganizationsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def get_user_role(self, organization_id: str) -> typing.Optional[UserOrganizationRole]:
+    async def get_user_role(
+        self, organization_id: str, *, project_id: typing.Optional[str] = None
+    ) -> typing.Optional[UserOrganizationRole]:
         """
         Get the role of a user in an organization.
 
         Parameters:
             - organization_id: str.
+
+            - project_id: typing.Optional[str].
         ---
         from llama_cloud.client import AsyncLlamaCloud
 
@@ -1237,6 +1246,7 @@ class AsyncOrganizationsClient:
             urllib.parse.urljoin(
                 f"{self._client_wrapper.get_base_url()}/", f"api/v1/organizations/{organization_id}/users/roles"
             ),
+            params=remove_none_from_dict({"project_id": project_id}),
             headers=self._client_wrapper.get_headers(),
             timeout=60,
         )