Manage unassigned projects#

An unassigned project is a project that isn’t assigned to an organization or organizational unit. Projects that are part of an organization or unit are easier to maintain as common settings like authentication are centrally managed at the organization level. These projects also get the latest feature updates.

Important

It’s no longer possible to create unassigned projects and projects that are not assigned to an organization or unit will not be updated with new features. We recommend assigning all projects to an organization or unit using the instructions on this page.

Learn more about organizations, organizational units, and projects.

Manage unassigned projects in Aiven Console#

Assign projects to an organization or unit#

If you don’t have an organization, you need to create one first.

To assign standalone projects to an organization or unit in the Aiven Console:

  1. Click Projects.

  2. Click View unassigned projects to see a list of all projects not assigned to an organization or organizational unit. If you don’t see View unassigned projects in the dropdown menu, then you don’t have any unassigned projects.

  3. On the Unassigned projects page, click Assign project for a project you want to assign.

  4. Add any other projects that you want to assign to the same organization or unit.

  5. Select the organization or organizational unit.

  6. Click Assign projects.

Create an organization#

Projects must be assigned to organizations or units. We recommend using only one organization and creating organizational units to group your projects.

If you don’t have any organization yet, you can create one:

  1. At the top right side, click Create organization.

  2. Enter a name for the organization.

  3. Select the projects that you want to assign to this organization. You can search for projects by name.

  4. If you want to invite admin users to the organization, set the toggle to Yes and enter their email addresses. They will receive an email invitation with a confirmation link.

    Important

    When admin users accept the invitation, they have full control over the organization and the projects assigned to it.

  5. Click Create organization.

The Admin page opens, where you can add organizational units, and manage users, groups, and other settings.

Manage unassigned projects with the API#

Check for unassigned projects#

To see a list of names of all unassigned projects use the following:

curl -sXGET \
 https://api.aiven.io/v1/project \
 -H "Authorization: Bearer TOKEN" | jq -r '.projects[] | select(.account_id==null) | .project_name'

Assign standalone projects to an organization or unit#

If you don’t have an organization, you need to create an organization first and then assign your projects to it.

To assign a standalone project to an organization or unit use the following call. Replace ACCOUNT_ID with the ID of the organization or unit and PROJECT_NAME with the name of the project to assign.

curl -sXPUT \
 https://api.aiven.io/v1/project/PROJECT_NAME \
 -H "Authorization: Bearer TOKEN" \
 -H 'content-type: application/json' \
 --data-raw '{"account_id":"ACCOUNT_ID","add_account_owners_admin_access":true}' | jq

Create an organization#

To create an organization use the following call. Replace ORG_NAME with a name for your new organization.

curl -sXPOST \
 https://api.aiven.io/v1/account \
 -H "Authorization: Bearer TOKEN" \
 -H 'content-type: application/json' \
 --data '{"account_name":"ORG_NAME"}' | jq