> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# プロジェクト API

> ionworks-api の Python サブクライアントを使用して、プログラムからプロジェクトを作成、一覧、フィルタリング、更新、削除します

[`ionworks-api`](https://github.com/ionworks/ionworks-api) Python パッケージは、[プロジェクト](/ja/core-concepts/projects-studies)をプログラムから管理するためのサブクライアントを提供します。インストールと認証については、[Python API クライアント](/ja/api-client)ページを参照してください。

## プロジェクトの一覧

```python theme={null}
from ionworks import Ionworks

client = Ionworks()

# List all projects
projects = client.project.list()
for project in projects:
    print(f"{project.name} (ID: {project.id})")

# Filter by name (case-insensitive substring match)
projects = client.project.list(name="NMC")

# Paginate results
projects = client.project.list(limit=10, offset=20)
print(f"Showing {projects.count} of {projects.total} projects")
```

サポートされるフィルター: `name`、`name_exact`、`created_by_email`、`created_after`、`created_before`、`updated_after`、`updated_before`、`order_by`、`order`。

## プロジェクトの取得

```python theme={null}
project = client.project.get("your-project-id")
print(f"{project.name}: {project.description}")
```

## プロジェクトの作成

```python theme={null}
project = client.project.create({
    "name": "NMC622 Characterization",
    "description": "Parameter identification for NMC622/Graphite cells",
})
print(f"Created project: {project.id}")
```

## プロジェクトの更新

```python theme={null}
project = client.project.update("your-project-id", {
    "name": "NMC622 Characterization v2",
    "description": "Updated description",
})
```

## プロジェクトの削除

```python theme={null}
client.project.delete("your-project-id")
```

<Tip>
  どのリソースの ID も、Ionworks Studio Web アプリから確認できます。リソースの詳細ページに移動すると、URL に ID が表示されます。
</Tip>
