CRcrowdin
Applications

Add Application KV Record

Required scopes: application.storage (Read and Write).

Adds a new KV record to the application installation's storage. If the key already exists, the request returns 409 - use Edit Application KV Record to change an existing record.

Note: Requires the application's own access token - personal access tokens are not supported

post/applications/{applicationIdentifier}/storage/kv/records

Request

Path parameters

applicationIdentifierstring required

Identifier of the application. Get via List Application Installations

Request body

keystring required

Key of the record. 1-500 characters from a-z, A-Z, 0-9, :, ., _, -. Unique within the installation, case-sensitive and immutable.

Keys with no reserved prefix are shared with everyone who can access the application. Reserved prefixes narrow visibility:

  • user:{userId}: - the user's own private records
  • module:{moduleKey}: - visible only to users with access to that module ({moduleKey} is a module key from the application manifest)
secretboolean

If true, the value is encrypted at rest. Immutable - to change it, delete the record and create a new one. Default is false

ttlinteger nullable

Time to live in seconds (60-31536000, inclusive). Omit for a permanent record

Example request

{
  "key": "settings.theme"
}

Response

Application KV Record was successfully created

Example response

{
  "data": {
    "key": "settings.theme",
    "createdAt": "2026-08-17T10:00:00+00:00",
    "updatedAt": "2026-08-17T10:00:00+00:00",
    "expiresAt": "2026-09-17T10:00:00+00:00"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.