## Retrieve

`projects.watermark.retrieve(strproject_id)  -> WatermarkRetrieveResponse`

**get** `/projects/{projectId}/watermark`

Get the project's forced watermark configuration

### Parameters

- `project_id: str`

### Returns

- `class WatermarkRetrieveResponse: …`

  - `watermark: Watermark`

    Forced-watermark configuration stored at one scope.

    - `id: str`

      Stable identifier derived from level + scopeId

    - `created_at: str`

      ISO-8601 creation timestamp

    - `created_by: str`

      User id that last wrote the configuration

    - `enabled: bool`

      Whether the watermark is enforced on assets generated in this scope. A
      disabled project configuration falls back to its team's.

    - `level: Literal["project", "team"]`

      Scope this configuration applies to: team or project

      - `"project"`

      - `"team"`

    - `opacity: float`

      Mark opacity, 0.05 (barely visible) to 1 (opaque)

    - `placement: Literal["bottom-left", "bottom-right", "center", 3 more]`

      Where the mark sits on the image

      - `"bottom-left"`

      - `"bottom-right"`

      - `"center"`

      - `"tiled"`

      - `"top-left"`

      - `"top-right"`

    - `rotation: float`

      Mark rotation in degrees, -90 to 90. 0 is horizontal.

    - `scale: float`

      Mark width as a fraction of the image width

    - `scope_id: str`

      The id of the team or project that owns this configuration

    - `spacing: float`

      Gap between repetitions, as a fraction of the mark's own size. Tiled
      placement only; 0 repeats the mark edge to edge.

    - `updated_at: str`

      ISO-8601 last-update timestamp

    - `version: float`

      Bumped on every write.

    - `deleted_at: Optional[str]`

      Set when the configuration has been deleted.

    - `logo_is_opaque: Optional[bool]`

      Whether the stored logo has no transparency at all.

      Recorded at upload so the UI can warn without decoding the image again: an
      opaque logo draws its whole rectangle, which a rotated tiled mark turns
      into a very visible diamond.

    - `logo_key: Optional[str]`

      Where the uploaded logo lives, when one is set.

    - `text: Optional[str]`

      Text rendered as the mark, when no logo is set

### Example

```python
import os
from scenario_sdk import Scenario

client = Scenario(
    api_key=os.environ.get("SCENARIO_SDK_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SCENARIO_SDK_API_SECRET"),  # This is the default and can be omitted
)
watermark = client.projects.watermark.retrieve(
    "projectId",
)
print(watermark.watermark)
```

#### Response

```json
{
  "watermark": {
    "id": "id",
    "createdAt": "createdAt",
    "createdBy": "createdBy",
    "enabled": true,
    "level": "project",
    "opacity": 0,
    "placement": "bottom-left",
    "rotation": 0,
    "scale": 0,
    "scopeId": "scopeId",
    "spacing": 0,
    "updatedAt": "updatedAt",
    "version": 0,
    "deletedAt": "deletedAt",
    "logoIsOpaque": true,
    "logoKey": "logoKey",
    "text": "text"
  }
}
```