Ory.Api.Project (ory_client v1.6.2)

API calls for all endpoints tagged Project.

Summary

Functions

Create a Project Creates a new project.

Create project API token Create an API token for a project.

Delete project API token Deletes an API token and immediately removes it.

Returns the Ory Network Project selected in the Ory Network Console Use this API to get your active project in the Ory Network Console UI.

Returns a B2B SSO Organization for a project by it's ID.

Get a Project Get a projects you have access to by its ID.

Get all members associated with this project This endpoint requires the user to be a member of the project with the role OWNER or DEVELOPER.

Retrieves project metrics for the specified event type and time range

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.ListOrganizationsResponse.t} on success
  • {:error, Tesla.Env.t} on failure

List a project's API Tokens A list of all the project's API tokens.

List All Projects Lists all projects you have access to.

Patch an Ory Network Project Configuration Deprecated: Use the patchProjectWithRevision endpoint instead to specify the exact revision the patch was generated for. This endpoints allows you to patch individual Ory Network project configuration keys for Ory's services (identity, permission, ...). The configuration format is fully compatible with the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions). This endpoint expects the version key to be set in the payload. If it is unset, it will try to import the config as if it is from the most recent version. If you have an older version of a configuration, you should set the version key in the payload! While this endpoint is able to process all configuration items related to features (e.g. password reset), it does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the open source. For configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings to help you understand which parts of your config could not be processed.

Irrecoverably purge a project !! Use with extreme caution !! Using this API endpoint you can purge (completely delete) a project and its data. This action can not be undone and will delete ALL your data. !! Use with extreme caution !!

Remove a member associated with this project This also sets their invite status to REMOVED. This endpoint requires the user to be a member of the project with the role OWNER.

Sets the Ory Network Project active in the Ory Network Console Use this API to set your active project in the Ory Network Console UI.

Update an Ory Network Project Configuration This endpoints allows you to update the Ory Network project configuration for individual services (identity, permission, ...). The configuration is fully compatible with the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions). This endpoint expects the version key to be set in the payload. If it is unset, it will try to import the config as if it is from the most recent version. If you have an older version of a configuration, you should set the version key in the payload! While this endpoint is able to process all configuration items related to features (e.g. password reset), it does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the open source. For configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings to help you understand which parts of your config could not be processed. Be aware that updating any service's configuration will completely override your current configuration for that service!

Functions

Link to this function

create_organization(connection, project_id, opts \\ [])

@spec create_organization(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, Ory.Model.Organization.t()}
  | {:error, Tesla.Env.t()}

Create a B2B SSO Organization

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters
    • :body (OrganizationBody):

Returns

  • {:ok, Ory.Model.Organization.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

create_project(connection, opts \\ [])

@spec create_project(
  Tesla.Env.client(),
  keyword()
) ::
  {:ok, Ory.Model.Project.t()}
  | {:ok, Ory.Model.ErrorGeneric.t()}
  | {:error, Tesla.Env.t()}

Create a Project Creates a new project.

Parameters

  • connection (Ory.Connection): Connection to server
  • opts (keyword): Optional parameters
    • :body (CreateProjectBody):

Returns

  • {:ok, Ory.Model.Project.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

create_project_api_key(connection, project, opts \\ [])

@spec create_project_api_key(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ProjectApiKey.t()}
  | {:ok, Ory.Model.ErrorGeneric.t()}
  | {:error, Tesla.Env.t()}

Create project API token Create an API token for a project.

Parameters

  • connection (Ory.Connection): Connection to server
  • project (String.t): The Project ID or Project slug
  • opts (keyword): Optional parameters
    • :body (CreateProjectApiKeyRequest):

Returns

  • {:ok, Ory.Model.ProjectApiKey.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

delete_organization(connection, project_id, organization_id, opts \\ [])

@spec delete_organization(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
  {:ok, nil} | {:ok, Ory.Model.ErrorGeneric.t()} | {:error, Tesla.Env.t()}

Delete a B2B SSO Organization for a project.

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • organization_id (String.t): Organization ID The Organization's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, nil} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

delete_project_api_key(connection, project, token_id, opts \\ [])

@spec delete_project_api_key(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
  {:ok, nil} | {:ok, Ory.Model.ErrorGeneric.t()} | {:error, Tesla.Env.t()}

Delete project API token Deletes an API token and immediately removes it.

Parameters

  • connection (Ory.Connection): Connection to server
  • project (String.t): The Project ID or Project slug
  • token_id (String.t): The Token ID
  • opts (keyword): Optional parameters

Returns

  • {:ok, nil} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_active_project_in_console(connection, opts \\ [])

@spec get_active_project_in_console(
  Tesla.Env.client(),
  keyword()
) ::
  {:ok, Ory.Model.GenericError.t()}
  | {:ok, Ory.Model.ActiveProjectInConsole.t()}
  | {:error, Tesla.Env.t()}

Returns the Ory Network Project selected in the Ory Network Console Use this API to get your active project in the Ory Network Console UI.

Parameters

  • connection (Ory.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.ActiveProjectInConsole.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_organization(connection, project_id, organization_id, opts \\ [])

@spec get_organization(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, Ory.Model.GetOrganizationResponse.t()}
  | {:error, Tesla.Env.t()}

Returns a B2B SSO Organization for a project by it's ID.

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • organization_id (String.t): Organization ID The Organization's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.GetOrganizationResponse.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_project(connection, project_id, opts \\ [])

@spec get_project(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.Project.t()}
  | {:ok, Ory.Model.ErrorGeneric.t()}
  | {:error, Tesla.Env.t()}

Get a Project Get a projects you have access to by its ID.

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.Project.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_project_members(connection, project, opts \\ [])

@spec get_project_members(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.GenericError.t()}
  | {:ok, [Ory.Model.CloudAccount.t()]}
  | {:error, Tesla.Env.t()}

Get all members associated with this project This endpoint requires the user to be a member of the project with the role OWNER or DEVELOPER.

Parameters

  • connection (Ory.Connection): Connection to server
  • project (String.t):
  • opts (keyword): Optional parameters

Returns

  • {:ok, [%CloudAccount{}, ...]} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

get_project_metrics(connection, project_id, event_type, resolution, from, to, opts \\ [])

@spec get_project_metrics(
  Tesla.Env.client(),
  String.t(),
  String.t(),
  String.t(),
  DateTime.t(),
  DateTime.t(),
  keyword()
) ::
  {:ok, Ory.Model.GetProjectMetricsResponse.t()}
  | {:ok, Ory.Model.GenericError.t()}
  | {:error, Tesla.Env.t()}

Retrieves project metrics for the specified event type and time range

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID
  • event_type (String.t): The event type to query for
  • resolution (String.t): The resolution of the buckets The minimum resolution is 1 hour.
  • from (DateTime.t): The start RFC3339 date of the time window
  • to (DateTime.t): The end RFC3339 date of the time window
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.GetProjectMetricsResponse.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

list_organizations(connection, project_id, opts \\ [])

@spec list_organizations(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ListOrganizationsResponse.t()}
  | {:ok, Ory.Model.ErrorGeneric.t()}
  | {:error, Tesla.Env.t()}

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, Ory.Model.ListOrganizationsResponse.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

list_project_api_keys(connection, project, opts \\ [])

@spec list_project_api_keys(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, [Ory.Model.ProjectApiKey.t()]}
  | {:error, Tesla.Env.t()}

List a project's API Tokens A list of all the project's API tokens.

Parameters

  • connection (Ory.Connection): Connection to server
  • project (String.t): The Project ID or Project slug
  • opts (keyword): Optional parameters

Returns

  • {:ok, [%ProjectApiKey{}, ...]} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

list_projects(connection, opts \\ [])

@spec list_projects(
  Tesla.Env.client(),
  keyword()
) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, [Ory.Model.ProjectMetadata.t()]}
  | {:error, Tesla.Env.t()}

List All Projects Lists all projects you have access to.

Parameters

  • connection (Ory.Connection): Connection to server
  • opts (keyword): Optional parameters

Returns

  • {:ok, [%ProjectMetadata{}, ...]} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

patch_project(connection, project_id, opts \\ [])

@spec patch_project(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, Ory.Model.SuccessfulProjectUpdate.t()}
  | {:error, Tesla.Env.t()}

Patch an Ory Network Project Configuration Deprecated: Use the patchProjectWithRevision endpoint instead to specify the exact revision the patch was generated for. This endpoints allows you to patch individual Ory Network project configuration keys for Ory's services (identity, permission, ...). The configuration format is fully compatible with the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions). This endpoint expects the version key to be set in the payload. If it is unset, it will try to import the config as if it is from the most recent version. If you have an older version of a configuration, you should set the version key in the payload! While this endpoint is able to process all configuration items related to features (e.g. password reset), it does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the open source. For configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings to help you understand which parts of your config could not be processed.

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters
    • :body ([Ory.Model.JsonPatch.t]):

Returns

  • {:ok, Ory.Model.SuccessfulProjectUpdate.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

purge_project(connection, project_id, opts \\ [])

@spec purge_project(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, nil} | {:ok, Ory.Model.GenericError.t()} | {:error, Tesla.Env.t()}

Irrecoverably purge a project !! Use with extreme caution !! Using this API endpoint you can purge (completely delete) a project and its data. This action can not be undone and will delete ALL your data. !! Use with extreme caution !!

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters

Returns

  • {:ok, nil} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

remove_project_member(connection, project, member, opts \\ [])

@spec remove_project_member(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
  {:ok, nil} | {:ok, Ory.Model.GenericError.t()} | {:error, Tesla.Env.t()}

Remove a member associated with this project This also sets their invite status to REMOVED. This endpoint requires the user to be a member of the project with the role OWNER.

Parameters

  • connection (Ory.Connection): Connection to server
  • project (String.t):
  • member (String.t):
  • opts (keyword): Optional parameters

Returns

  • {:ok, nil} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

set_active_project_in_console(connection, opts \\ [])

@spec set_active_project_in_console(
  Tesla.Env.client(),
  keyword()
) :: {:ok, nil} | {:ok, Ory.Model.GenericError.t()} | {:error, Tesla.Env.t()}

Sets the Ory Network Project active in the Ory Network Console Use this API to set your active project in the Ory Network Console UI.

Parameters

  • connection (Ory.Connection): Connection to server
  • opts (keyword): Optional parameters
    • :body (SetActiveProjectInConsoleBody):

Returns

  • {:ok, nil} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

set_project(connection, project_id, opts \\ [])

@spec set_project(Tesla.Env.client(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, Ory.Model.SuccessfulProjectUpdate.t()}
  | {:error, Tesla.Env.t()}

Update an Ory Network Project Configuration This endpoints allows you to update the Ory Network project configuration for individual services (identity, permission, ...). The configuration is fully compatible with the open source projects for the respective services (e.g. Ory Kratos for Identity, Ory Keto for Permissions). This endpoint expects the version key to be set in the payload. If it is unset, it will try to import the config as if it is from the most recent version. If you have an older version of a configuration, you should set the version key in the payload! While this endpoint is able to process all configuration items related to features (e.g. password reset), it does not support operational configuration items (e.g. port, tracing, logging) otherwise available in the open source. For configuration items that can not be translated to the Ory Network, this endpoint will return a list of warnings to help you understand which parts of your config could not be processed. Be aware that updating any service's configuration will completely override your current configuration for that service!

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • opts (keyword): Optional parameters
    • :body (SetProject):

Returns

  • {:ok, Ory.Model.SuccessfulProjectUpdate.t} on success
  • {:error, Tesla.Env.t} on failure
Link to this function

update_organization(connection, project_id, organization_id, opts \\ [])

@spec update_organization(Tesla.Env.client(), String.t(), String.t(), keyword()) ::
  {:ok, Ory.Model.ErrorGeneric.t()}
  | {:ok, Ory.Model.Organization.t()}
  | {:error, Tesla.Env.t()}

Update a B2B SSO Organization for a project.

Parameters

  • connection (Ory.Connection): Connection to server
  • project_id (String.t): Project ID The project's ID.
  • organization_id (String.t): Organization ID The Organization's ID.
  • opts (keyword): Optional parameters
    • :body (OrganizationBody):

Returns

  • {:ok, Ory.Model.Organization.t} on success
  • {:error, Tesla.Env.t} on failure