# Update several strings

`POST https://app.shuttleglobal.com/c/api/instances/{instance_key}/strings`

Updates the wording of several strings in one request, for one language. Strings not
included are left as they are.

- Every item in one request must use the same `language` (and `branding`, if you send it).
  Send one request per language.
- Each item is applied as [Update a string](/platforms/reference/operations/updatestring/) would apply it:
  sending the wording the string already inherits removes your override.
- An id whose set (the part before the first dot) is not recognised rejects the request
  before anything is written. Only use ids returned by [List strings](/platforms/reference/operations/liststrings/).
- The update is not atomic. Sets are written one after another, so a failure part-way leaves
  the earlier sets saved. Re-sending the same request is safe.
- Send requests one at a time. Writes to a branding are queued, and a write still waiting
  after 10 seconds is refused (`BOLT-7059`).
- The request body must be under 10 MB.

## Authentication

- basicAuth: Basic Authentication using secret key
- bearerAuth: OAuth 2.0 Bearer Token Authentication

## Request body (`application/json`), required

- `strings` (array of items, required)

## Responses

### 200: The updated strings as they now read

```json
{
  "strings": [
    {
      "id": "web.payment_form.card_number",
      "text": "رقم البطاقة",
      "language": "ar",
      "branding": "string",
      "overriding": "Card Number"
    }
  ]
}
```

### 400: Bad request

```json
{
  "code": "string",
  "message": "string"
}
```

### 401: Authentication required

```json
{
  "code": "UNAUTHORIZED",
  "message": "Unauthorised"
}
```

## Example request

```sh
curl --request POST \
  --url https://app.shuttleglobal.com/c/api/instances/YOUR_INSTANCE_KEY/strings \
  --header 'Authorization: Basic <base64 of SECRET_KEY:>' \
  --header 'Content-Type: application/json' \
  --data '{
  "strings": [
    "string"
  ]
}'
```

Reference page: https://docs.shuttleglobal.com/platforms/reference/operations/updatestrings/