# Platform

## Retrieve

`platform.retrieve()  -> PlatformRetrieveResponse`

**get** `/platform`

Gets platform details for the workspace

### Returns

- `class PlatformRetrieveResponse: …`

  - `data: Data`

    Platform object

    - `created: datetime`

      ISO 8601 timestamp when the platform was created

    - `display_name: str`

      Display name for the platform

    - `workspace_id: str`

      Workspace ID this platform belongs to

    - `modified: Optional[datetime]`

      ISO 8601 timestamp when the platform was last modified

### Example

```python
from fragment import Fragment

client = Fragment()
platform = client.platform.retrieve()
print(platform.data)
```

## Update

`platform.update(PlatformUpdateParams**kwargs)  -> PlatformUpdateResponse`

**post** `/platform`

Updates platform details (creates if not exists)

### Parameters

- `display_name: str`

  Display name for the platform

### Returns

- `class PlatformUpdateResponse: …`

  - `data: Data`

    Platform object

    - `created: datetime`

      ISO 8601 timestamp when the platform was created

    - `display_name: str`

      Display name for the platform

    - `workspace_id: str`

      Workspace ID this platform belongs to

    - `modified: Optional[datetime]`

      ISO 8601 timestamp when the platform was last modified

### Example

```python
from fragment import Fragment

client = Fragment()
platform = client.platform.update(
    display_name="Acme Corp",
)
print(platform.data)
```