> For the complete documentation index, see [llms.txt](https://api-docs.intratool.help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.intratool.help/api-reference/legal/imprints.md).

# Imprints

## Introduction

`Imprints` provide an organization's legal disclosure as inline content or a link.

The `text` field uses the shared [Rich Text](/introduction/rich-text.md) HTML format.

## Model Definition

**Alias**

`imprint`

**Capabilities**

* [Translations](/introduction/resource-capabilities/translations.md) - Localizes `text`; examples use `en-US`.

## Admin: List

List all `Imprints` in administration scope.

**Definition**

<mark style="color:green;">`GET`</mark> `/api/administration/imprints`

**Request Keys**

| Key      | Type      | Default          | Description                                                           |
| -------- | --------- | ---------------- | --------------------------------------------------------------------- |
| `select` | `string`  | All fields       | Comma-separated fields to return.                                     |
| `limit`  | `integer` | No limit         | Maximum number of records.                                            |
| `filter` | `object`  | No filters       | [Value filters](/introduction/query-manipulation/value-filters.md).   |
| `sort`   | `string`  | Repository order | Comma-separated fields; prefix a field with `-` for descending order. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/administration/imprints', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
[
  {
    "id": 1,
    "user_id": 3,
    "lang_id": "en-US",
    "link": null,
    "text": "<p><strong>Example Company GmbH</strong><br>Example Street 1<br>10115 Berlin</p>",
    "created_at": "2026-08-01 09:00:00",
    "updated_at": null
  },
  {
    "id": 2,
    "user_id": 4,
    "lang_id": "en-US",
    "link": "https://www.example.com/legal/imprint",
    "text": null,
    "created_at": "2026-08-07 10:30:00",
    "updated_at": null
  }
]
```

## Admin: Show

Show one `Imprint` in administration scope.

**Definition**

<mark style="color:green;">`GET`</mark> `/api/administration/imprints/{imprint}`

**Route Parameters**

| Parameter | Type      | Description |
| --------- | --------- | ----------- |
| `imprint` | `integer` | Imprint ID. |

**Request Keys**

| Key      | Type     | Default    | Description                       |
| -------- | -------- | ---------- | --------------------------------- |
| `select` | `string` | All fields | Comma-separated fields to return. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('GET', '/api/administration/imprints/1', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "id": 1,
  "user_id": 3,
  "lang_id": "en-US",
  "link": null,
  "text": "<p><strong>Example Company GmbH</strong><br>Example Street 1<br>10115 Berlin</p>",
  "created_at": "2026-08-01 09:00:00",
  "updated_at": null
}
```

## Admin: Create

Create a new `Imprint`.

**Definition**

<mark style="color:yellow;">`POST`</mark> `/api/administration/imprints`

**Request Keys**

| Key       | Type               | Default         | Description                                                         |
| --------- | ------------------ | --------------- | ------------------------------------------------------------------- |
| `lang_id` | `string`           | System language | Language key. Use `en-US` for this example.                         |
| `text`    | `string` \| `null` | `null`          | Disclosure content in [Rich Text](/introduction/rich-text.md) HTML. |
| `link`    | `string` \| `null` | `null`          | URL that provides the disclosure.                                   |

**Behavior**

* At least one of `text` or `link` is required.
* When `link` has a value, the imprint redirects to that URL instead of rendering `text`.
* The authenticated user is stored as the creating user.

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('POST', '/api/administration/imprints', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'lang_id' => 'en-US',
        'text' => '<p><strong>Example Company GmbH</strong><br>Example Street 1<br>10115 Berlin</p>'
    ]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "status": "success",
  "data": {
    "id": 3,
    "user_id": 3,
    "lang_id": "en-US",
    "link": null,
    "text": "<p><strong>Example Company GmbH</strong><br>Example Street 1<br>10115 Berlin</p>",
    "created_at": "2026-08-07 11:00:00",
    "updated_at": null
  }
}
```

## Admin: Update

Update an existing `Imprint`.

**Definition**

<mark style="color:blue;">`PUT`</mark> `/api/administration/imprints/{imprint}`

**Route Parameters**

| Parameter | Type      | Description |
| --------- | --------- | ----------- |
| `imprint` | `integer` | Imprint ID. |

**Request Keys**

| Key       | Type               | Description                                                         |
| --------- | ------------------ | ------------------------------------------------------------------- |
| `lang_id` | `string`           | Language key.                                                       |
| `text`    | `string` \| `null` | Disclosure content in [Rich Text](/introduction/rich-text.md) HTML. |
| `link`    | `string` \| `null` | URL that provides the disclosure.                                   |

**Behavior**

* Each update must provide at least one of `text` or `link`.
* When `link` has a value, the imprint redirects to that URL instead of rendering `text`.
* The authenticated user replaces the creating user stored on the record.

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('PUT', '/api/administration/imprints/3', [
    'headers' => ['Authorization' => "Bearer {accessToken}"],
    'json' => [
        'lang_id' => 'en-US',
        'link' => 'https://www.example.com/legal/imprint'
    ]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "status": "success",
  "data": {
    "id": 3,
    "user_id": 3,
    "lang_id": "en-US",
    "link": "https://www.example.com/legal/imprint",
    "text": "<p><strong>Example Company GmbH</strong><br>Example Street 1<br>10115 Berlin</p>",
    "created_at": "2026-08-07 11:00:00",
    "updated_at": null
  }
}
```

## Admin: Delete

Delete an existing `Imprint`.

**Definition**

<mark style="color:red;">`DELETE`</mark> `/api/administration/imprints/{imprint}`

**Route Parameters**

| Parameter | Type      | Description |
| --------- | --------- | ----------- |
| `imprint` | `integer` | Imprint ID. |

**Example Request**

{% tabs %}
{% tab title="PHP" %}

```php
$client = new GuzzleHttp\Client(['base_uri' => 'https://{tenant}.intratool.de']);
$response = $client->request('DELETE', '/api/administration/imprints/3', [
    'headers' => ['Authorization' => "Bearer {accessToken}"]
]);
```

{% endtab %}
{% endtabs %}

**Example Response**

```json
{
  "status": "success",
  "data": null
}
```