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

# Suppression list salt

> This key's 32-byte salt, with which it computes each destination's key; kept as a secret.



## OpenAPI

````yaml openapi/en/cell.json GET /v1/suppressions/salt
openapi: 3.1.0
info:
  title: Niadra data API
  version: '1'
  description: >-
    Writing, context, history, objects, identity, privacy and governance of one
    space. Every space has a stable address, with the space and the region in
    its name.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: The space, which comes in the source key.
      region:
        default: us-east-2
        description: The region of the space, which also comes in the key.
security: []
paths:
  /v1/suppressions/salt:
    get:
      tags:
        - coordination
      summary: Suppression list salt
      description: >-
        The 32-byte salt of the calling key, base64url, with which it computes
        the key of each destination. Two readers of one space get different keys
        for the same person. Keep it as a secret and never send it or the keys
        anywhere else.


        **Authentication.** Source key: `Authorization: Bearer nia_sk_...`.
        Required scope: `coordinate`. It answers only in a space with the
        `coordination` feature on (the `features` document); in a space without
        it, 404.
      operationId: suppression_salt_v1_suppressions_salt_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuppressionSalt'
          description: The salt, its id and since when it applies.
      security:
        - sourceKey: []
components:
  schemas:
    SuppressionSalt:
      additionalProperties: false
      properties:
        salt:
          pattern: ^[A-Za-z0-9_-]{43}$
          title: Salt
          type: string
        salt_id:
          maxLength: 512
          minLength: 1
          title: Salt Id
          type: string
        valid_from:
          format: date-time
          title: Valid From
          type: string
      required:
        - salt_id
        - salt
        - valid_from
      title: SuppressionSalt
      type: object
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...

````