# ai-account

## ai_account_orgs_credential_retrieve

 - [GET /api/ai-account/orgs/{org}/credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_credential_retrieve.md): Retrieve LLM credentials for an organization.

Query Parameters:
    name (optional): Filter results by LLM provider name

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: List of LLM credentials for the organization

Raises:
    NotFound: When organization is not found or when no credentials match the filters
    ValidationError: When query parameters are invalid

## ai_account_orgs_credential_create

 - [POST /api/ai-account/orgs/{org}/credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_credential_create.md): Create a new LLM credential for an organization.

Args:
    request: The HTTP request containing credential information
    org: Organization key identifier

Returns:
    Response: Created LLM credential

Raises:
    NotFound: When organization is not found
    ValidationError: When request data is invalid

## ai_account_orgs_credential_partial_update

 - [PATCH /api/ai-account/orgs/{org}/credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_credential_partial_update.md): Update an existing LLM credential for an organization.

Args:
    request: The HTTP request containing updated credential information
    org: Organization key identifier

Returns:
    Response: Updated LLM credential

Raises:
    NotFound: When organization or credential is not found
    ValidationError: When request data is invalid

## ai_account_orgs_integration_credential_retrieve

 - [GET /api/ai-account/orgs/{org}/integration-credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_integration_credential_retrieve.md): Retrieve integration credentials for an organization.

Query Parameters:
    name (optional): Filter results by integration service name

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: List of integration credentials for the organization

Raises:
    NotFound: When organization is not found or when no credentials match the filters
    ValidationError: When query parameters are invalid

## ai_account_orgs_integration_credential_create

 - [POST /api/ai-account/orgs/{org}/integration-credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_integration_credential_create.md): Create a new integration credential for an organization.

Args:
    request: The HTTP request containing credential information
    org: Organization key identifier

Returns:
    Response: Created integration credential

Raises:
    NotFound: When organization is not found
    ValidationError: When request data is invalid

## ai_account_orgs_integration_credential_partial_update

 - [PATCH /api/ai-account/orgs/{org}/integration-credential/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_integration_credential_partial_update.md): Update an existing integration credential for an organization.

Args:
    request: The HTTP request containing updated credential information
    org: Organization key identifier

Returns:
    Response: Updated integration credential

Raises:
    NotFound: When organization or credential is not found
    ValidationError: When request data is invalid

## ai_account_orgs_platform_metadata_list

 - [GET /api/ai-account/orgs/{org}/platform-metadata/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_platform_metadata_list.md): Retrieve platform metadata for a specific organization.

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: Platform metadata including service configurations and active services

Raises:
    NotFound: When platform metadata is not found

## ai_account_orgs_platform_metadata_create

 - [POST /api/ai-account/orgs/{org}/platform-metadata/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_platform_metadata_create.md): Create or update platform metadata for a specific organization.

Args:
    request: The HTTP request containing metadata information
    org: Organization key identifier

Returns:
    Response: Created/updated platform metadata

Raises:
    NotFound: When platform is not found
    ValidationError: When request data is invalid

## ai_account_orgs_platform_metadata_update

 - [PUT /api/ai-account/orgs/{org}/platform-metadata/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_platform_metadata_update.md): Update specific fields of platform metadata for an organization.

This endpoint allows updating the active LLM provider and available LLMs.

Args:
    request: The HTTP request containing update information
    org: Organization key identifier

Returns:
    Response: Updated platform metadata

Raises:
    NotFound: When platform metadata is not found
    ValidationError: When request data is invalid

## ai_account_orgs_tokens_list

 - [GET /api/ai-account/orgs/{org}/tokens/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_tokens_list.md): Retrieve weekly token usage statistics for an organization.

Query Parameters:
    username (optional): Filter results by specific username
    session_id (optional): Filter results by specific session ID

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: List of weekly token usage records with prompt and completion tokens

Raises:
    NotFound: When organization is not found or when no sessions match the filters
    ValidationError: When query parameters are invalid

## ai_account_orgs_use_default_llm_key_create

 - [POST /api/ai-account/orgs/{org}/use-default-llm-key/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_use_default_llm_key_create.md): Enable or disable the use of main LLM credentials for an organization.

Request Body:
    enable (boolean): Set to true to enable main credentials
    disable (boolean): Set to true to disable main credentials

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: Confirmation message

Raises:
    ValidationError: When neither enable nor disable is specified

## ai_account_orgs_use_free_trial_create

 - [POST /api/ai-account/orgs/{org}/use-free-trial/](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_use_free_trial_create.md): Enable, disable, or update free trial settings for an organization.

Request Body:
    enable (boolean): Set to true to enable free trial
    disable (boolean): Set to true to disable free trial
    metadata (object, optional): Additional metadata for the free trial

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: Confirmation message

## ai_account_orgs_users_default_llm_key_usage_retrieve

 - [GET /api/ai-account/orgs/{org}/users/{user_id}/default-llm-key-usage](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_users_default_llm_key_usage_retrieve.md): Retrieve the status of main LLM credential usage for an organization.

Args:
    request: The HTTP request
    org: Organization key identifier
    user_id: User identifier

Returns:
    Response: Status of main LLM credential usage

## ai_account_orgs_users_free_trial_retrieve

 - [GET /api/ai-account/orgs/{org}/users/{user_id}/free-trial](https://docs.ibl.ai/apis/ibl/ai-account/ai_account_orgs_users_free_trial_retrieve.md): Retrieve the free trial status for an organization.

Args:
    request: The HTTP request
    org: Organization key identifier

Returns:
    Response: Free trial status (boolean)

Raises:
    NotFound: When organization is not found