Project

Create a project

Changed on

The API endpoint /v1/project is deprecated. Use https://api.aiven.io/v1/organization/{organization\_id}/projects instead. It will be removed on 2027-01-31.

post/project

Request

  • Base URL
    https://api.aiven.io/v1
  • URL
    https://api.aiven.io/v1/project
  • Auth
    HTTP bearer and OAuth 2
    Authorization code: https://console.aiven.io/oauth/authorize
    Token URL: https://api.aiven.io/v1/oauth2/token scopes: projects:write

Request body

account_idstring

Account ID

add_account_owners_admin_accessboolean

[DEPRECATED] If account_id is set, grant account owner team admin access to the new project. This flag is ignored, and assumed true.

address_linesstring[]

[DEPRECATED] Address lines

base_portinteger

New services in this project will use this value as a base when deriving their service port numbers. This allows new services to allocate predictable and specific service ports. If not provided during project creation a random base port is used.

billing_addressstring

DEPRECATED: use split address fields like company, address_lines, zip_code, city and state instead

billing_currency'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'JPY' | 'NOK' | 'NZD' | 'SEK' | 'SGD' | 'USD'

[DEPRECATED] Billing currency

billing_extra_textstring

[DEPRECATED] Extra text to be included in all project invoices

billing_group_idstring

Billing group ID

card_idstring

[DEPRECATED] Credit card ID

citystring

[DEPRECATED] Address city

cloudstring

Target cloud

companystring

[DEPRECATED] Name of company

copy_from_projectstring

Project name from which to copy settings to the new project

copy_tagsboolean

Copy tags from the source project. If request contains additional tags, the tags copied from source are updated with them.

country_codestring

[DEPRECATED] Two letter country code for billing country

projectstring required

Project name

statestring

[DEPRECATED] Address state

tagsobject

Set of resource tags

use_source_project_billing_groupboolean

If set to true, use the same billing group that is used in source project. If set to false, create a copy of the billing group used in the source project with the same information. If new project is not being copied from existing one this option has no effect

vat_idstring

[DEPRECATED] EU VAT identification

zip_codestring

[DEPRECATED] Address zip code

Response

Response

messagestring

Printable result of the request

Changes

  • 269a5669335cRevision changes
    • info

      endpoint deprecated

  • 9b2b0f1b0fa9Revision changes
    • breaking

      the request property's maxLength was decreased to 50

    • breaking

      the request property's maxLength was decreased to 30

    • breaking

      the / response property's maxLength was increased from 32 to 36 for the response status

    • info

      the request property's maxLength was increased from 32 to 36