> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/mariadb-cloud/reference/mariadb-cloud-api-reference-guide/projects.md).

# Projects

## GET /organization/v1/projects

> Gets a projects within the organization.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"tags":[{"name":"Projects"}],"servers":[{"url":"https://api.skysql.com/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"dto.Project":{"type":"object","properties":{"created_by":{"type":"string"},"created_on":{"type":"integer"},"description":{"type":"string"},"id":{"type":"string"},"is_default":{"type":"boolean"},"name":{"type":"string"},"updated_by":{"type":"string"},"updated_on":{"type":"integer"}}}}},"paths":{"/organization/v1/projects":{"get":{"tags":["Projects"],"summary":"Gets a projects within the organization.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/dto.Project"}}}}},"204":{"description":"No Content"}}}}}}
```

## POST /organization/v1/projects

> Creates a new project in organization

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"tags":[{"name":"Projects"}],"servers":[{"url":"https://api.skysql.com/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"dto.CreateProject":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"}}}}},"paths":{"/organization/v1/projects":{"post":{"tags":["Projects"],"summary":"Creates a new project in organization","responses":{"201":{"description":"Created"}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/dto.CreateProject"}}},"description":"Request Body","required":true}}}}}
```

## PUT /organization/v1/projects

> Creates a new project in organization

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"tags":[{"name":"Projects"}],"servers":[{"url":"https://api.skysql.com/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"dto.CreateProject":{"type":"object","properties":{"description":{"type":"string"},"name":{"type":"string"}}}}},"paths":{"/organization/v1/projects":{"put":{"tags":["Projects"],"summary":"Creates a new project in organization","deprecated":true,"responses":{"201":{"description":"Created"}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/dto.CreateProject"}}},"description":"Request Body","required":true}}}}}
```

## GET /organization/v1/projects/{project\_id}

> Gets a project by project id within the organization.

```json
{"openapi":"3.1.1","info":{"title":"MariaDB Cloud DBaaS API","version":"1.0"},"tags":[{"name":"Projects"}],"servers":[{"url":"https://api.skysql.com/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"apiKey","name":"X-API-Key","in":"header"}},"schemas":{"dto.Project":{"type":"object","properties":{"created_by":{"type":"string"},"created_on":{"type":"integer"},"description":{"type":"string"},"id":{"type":"string"},"is_default":{"type":"boolean"},"name":{"type":"string"},"updated_by":{"type":"string"},"updated_on":{"type":"integer"}}}}},"paths":{"/organization/v1/projects/{project_id}":{"get":{"tags":["Projects"],"summary":"Gets a project by project id within the organization.","parameters":[{"schema":{"type":"string"},"description":"Project identifier","name":"project_id","in":"path","required":true}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/dto.Project"}}}}}}}}}
```