# PostAccountsAccountCapabilitiesCapability

From **Stripe API**.

`POST /v1/accounts/{account}/capabilities/{capability}`

<p>Updates an existing Account Capability.</p>

## Parameters

### `account`

- Location: path
- Required: true
- Type: `string`
- maxLength: `5000`

### `capability`

- Location: path
- Required: true
- Type: `string`

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"additionalProperties":false,"properties":{"expand":{"description":"Specifies which fields in the response should be expanded.","items":{"maxLength":5000,"type":"string"},"type":"array"},"requested":{"description":"Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.","type":"boolean"}},"type":"object"}
```

## Security

### `basicAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.

Basic HTTP authentication. Allowed headers-- Authorization: Basic <api_key> | Authorization: Basic <base64 hash of `api_key:`>

### `bearerAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

## Responses

### `200`

Successful response.

### `application/json`

- Type: `object`

This is an object representing a capability for a Stripe account.

Related guide: [Account capabilities](https://stripe.com/docs/connect/account-capabilities).

```json
{"description":"This is an object representing a capability for a Stripe account.\n\nRelated guide: [Account capabilities](https://stripe.com/docs/connect/account-capabilities).","properties":{"account":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/account"}],"description":"The account for which the capability enables functionality.","x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/account"}]}},"future_requirements":{"$ref":"#/components/schemas/account_capability_future_requirements"},"id":{"description":"The identifier for the capability.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["capability"],"type":"string"},"requested":{"description":"Whether the capability has been requested.","type":"boolean"},"requested_at":{"description":"Time at which the capability was requested. Measured in seconds since the Unix epoch.","format":"unix-time","nullable":true,"type":"integer"},"requirements":{"$ref":"#/components/schemas/account_capability_requirements"},"status":{"description":"The status of the capability. Can be `active`, `inactive`, `pending`, or `unrequested`.","enum":["active","disabled","inactive","pending","unrequested"],"type":"string"}},"required":["account","id","object","requested","status"],"title":"AccountCapability","type":"object","x-expandableFields":["account","future_requirements","requirements"],"x-resourceId":"capability"}
```

### `default`

Error response.

### `application/json`

- Type: `object`

An error response from the Stripe API

```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request POST \
  --url https://api.stripe.com/v1/accounts/{account}/capabilities/{capability} \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{
  "expand": [
    "string"
  ],
  "requested": true
}'
```