# Create registry request

`POST /v1/projects/{project}/registry-requests`, operation `environments.CreateRegistryRequest`

Asks a project's organization to share a registry covering an image or an address.

It names no registry, so that a project learns nothing of what its organization doesn't share with it. Asking again while a request waits returns that request.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `project` | path | Yes | `string` | The project's ID. |

## Request body

Content-Type: `application/json` (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `address` | `string` | Yes | An image, such as ghcr.io/acme/devbox:1, or a registry's address, such as ghcr.io/acme. |

## Responses

### 201

Created

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `address` | `string` | Yes | What it asked for, as a registry's prefix would name it, such as ghcr.io/acme/devbox. |
| `createTime` | `string (date-time)` | Yes | When it was asked. |
| `decideTime` | `string (date-time)` | No | When it was decided. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}/registry-requests/{request_id}. |
| `project` | `string` | Yes | The project that asked, projects/{project_id}. |
| `registry` | `string` | No | The registry shared with the project, once approved. |
| `requester` | `string` | Yes | Who asked, as a member such as user:usr_…. |
| `state` | `string` | Yes | PENDING until an Owner decides. Values: `PENDING`, `APPROVED`, `DECLINED`. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.