# State or change the business goal

`PUT /agents/assistant/business-goal` · Rivier · agents

State or change the business goal: one sentence, with an optional measure and day. Only a person who administers the project does this; a key or an agent is refused.

- Scope: agents:write
- Sdk: agents.assistant.businessGoalSet
- Cli: agents assistant business goal set

## Request body

`application/json`

```json
{
  "type": "object",
  "properties": {
    "outcome": {
      "type": "string",
      "minLength": 3,
      "maxLength": 280
    },
    "measure": {
      "type": "string",
      "maxLength": 160
    },
    "by": {
      "type": "string"
    }
  },
  "required": [
    "outcome"
  ],
  "additionalProperties": false
}
```

## Responses

- `200`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X PUT 'https://api.rivier.ai/agents/assistant/business-goal' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "outcome": "string"
}'
```