Ory.Api.Project (ory_client v1.6.2)
API calls for all endpoints tagged Project
.
Summary
Functions
Create a B2B SSO Organization
Create a Project Creates a new project.
Create project API token Create an API token for a project.
Delete a B2B SSO Organization 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 serverproject_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!
Update a B2B SSO Organization for a project.
Functions
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 serverproject_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
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 serveropts
(keyword): Optional parameters:body
(CreateProjectBody):
Returns
{:ok, Ory.Model.Project.t}
on success{:error, Tesla.Env.t}
on failure
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 serverproject
(String.t): The Project ID or Project slugopts
(keyword): Optional parameters:body
(CreateProjectApiKeyRequest):
Returns
{:ok, Ory.Model.ProjectApiKey.t}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_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
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 serverproject
(String.t): The Project ID or Project slugtoken_id
(String.t): The Token IDopts
(keyword): Optional parameters
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
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 serveropts
(keyword): Optional parameters
Returns
{:ok, Ory.Model.ActiveProjectInConsole.t}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_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
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 serverproject_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
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 serverproject
(String.t):opts
(keyword): Optional parameters
Returns
{:ok, [%CloudAccount{}, ...]}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_id
(String.t): Project IDevent_type
(String.t): The event type to query forresolution
(String.t): The resolution of the buckets The minimum resolution is 1 hour.from
(DateTime.t): The start RFC3339 date of the time windowto
(DateTime.t): The end RFC3339 date of the time windowopts
(keyword): Optional parameters
Returns
{:ok, Ory.Model.GetProjectMetricsResponse.t}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_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_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 serverproject
(String.t): The Project ID or Project slugopts
(keyword): Optional parameters
Returns
{:ok, [%ProjectApiKey{}, ...]}
on success{:error, Tesla.Env.t}
on failure
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 serveropts
(keyword): Optional parameters
Returns
{:ok, [%ProjectMetadata{}, ...]}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_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
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 serverproject_id
(String.t): Project ID The project's ID.opts
(keyword): Optional parameters
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
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 serverproject
(String.t):member
(String.t):opts
(keyword): Optional parameters
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
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 serveropts
(keyword): Optional parameters:body
(SetActiveProjectInConsoleBody):
Returns
{:ok, nil}
on success{:error, Tesla.Env.t}
on failure
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 serverproject_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
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 serverproject_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