# Add models to your organization

Add a provider's models to your organization under aliases, and share each with the projects that can use it, without sharing the provider.

Add models to your organization, and share each with the projects that can use it. A project you share a model with adds that model, and no other, without the provider being shared with it. To add models, you need Owner or LLM Gateway Admin on the organization.

You need your organization's provider first, its key for the model provider: [Add a provider](/guides/llm-gateway/add-a-provider) shows how.

## Add models [#add-models]

1. In your organization, click **LLM Gateway**. It opens on **Models**.
2. Click **Add models**, and select the provider that serves them.
3. Select the models to add from those the provider lists. Enter part of a name to filter them. For a model the provider serves but doesn't list, click **Add by ID** and enter its **Model ID**.
4. Click **Next**.
5. Enter each model's alias, such as `fast` or `smart`. An alias is unique among your organization's models, and is what projects call the model by unless they set another.
6. Under **Projects that can use it**, select **All projects** or **Selected projects**, or keep **No projects yet** and share it later.
7. Click **Add model**.

The models show under their provider. The projects you shared them with can now add them: [Add models to a project](/guides/llm-gateway/add-models-to-a-project#add-a-model-your-organization-shares) shows how. A provider's **Models** tab lists its models too, and adds more.

## Change a model or who can use it [#change-a-model-or-who-can-use-it]

1. In your organization, click **LLM Gateway**.
2. On the model's row, click **Edit**.
3. Change its **Alias**, its **Name (optional)** or the projects that can use it, and click **Save**.

Projects keep their own aliases for the model. A project you no longer share the model with keeps it, but its requests fail and it shows **Needs attention** until you share the model with it again.

## Delete a model [#delete-a-model]

1. In your organization, click **LLM Gateway**.
2. On the model's row, click **Delete**, then **Delete model**.

The projects that added the model lose it too, and their requests for it fail.

## Add a model with the API [#add-a-model-with-the-api]

Set your API key ([Call the API](/get-started/call-the-api)), your organization's ID, your provider's resource name and the project's ID:

```sh
export KOSEM_API_KEY='kosem_sk_…'
export KOSEM_ORG='org_01m5r8w2k3e9vbt6g0d4x7qz1h'
export KOSEM_PROVIDER='organizations/org_01m5r8w2k3e9vbt6g0d4x7qz1h/providers/prv_01m5raq8h2e4vbt6g0d4x7qz1j'
export KOSEM_PROJECT='prj_01m5r9dh9mf0ps98ktkap3562c'

curl -s -X POST "https://api.kosem.ai/v1/organizations/$KOSEM_ORG/models" \
  -H "Authorization: Bearer $KOSEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"alias\": \"fast\", \"provider\": \"$KOSEM_PROVIDER\", \"providerModel\": \"claude-haiku-4-5\", \"availability\": {\"allProjects\": false, \"projects\": [\"projects/$KOSEM_PROJECT\"]}}"
```

kosem answers with the model:

```json
{
  "name": "organizations/org_01m5r8w2k3e9vbt6g0d4x7qz1h/models/mdl_01m5rb2x9ke4vbt6g0d4x7qz1k",
  "alias": "fast",
  "providerModel": "claude-haiku-4-5",
  "availability": { "allProjects": false, "projects": ["projects/prj_01m5r9dh9mf0ps98ktkap3562c"] },
  "formats": ["ANTHROPIC_MESSAGES", "OPENAI_CHAT_COMPLETIONS", "OPENAI_RESPONSES"],
  "nativeFormats": ["ANTHROPIC_MESSAGES"]
}
```

Choosing whom a model is shared with takes Owner or LLM Gateway Admin on the organization. To delete a model that projects added, send `DELETE` with `?force=true`, which deletes what they added of it too: without it, kosem answers `MODEL_ADOPTED` ([Errors](/reference/errors#llm-gateways-providers-and-models)).

## Related [#related]

- [LLM Gateway](/concepts/llm-gateway)
- [Add a provider](/guides/llm-gateway/add-a-provider)
- [Add models to a project](/guides/llm-gateway/add-models-to-a-project)
