---
title: "PUT /api/v1/affiliations/{affiliation}"
method: PUT
path: "/api/v1/affiliations/{affiliation}"
tags: ["fabric-ca-server"]
---

# PUT /api/v1/affiliations/{affiliation}

`PUT /api/v1/affiliations/{affiliation}`

Rename an affiliation.  
The caller must have **hf.AffiliationMgr** authority.

## Path parameters

- `affiliation` string, required

## Query parameters

- `ca` string
- `force` boolean

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string, required — The new affiliation path.
  - `caname` string — Name of the CA to send the request to within the Fabric CA server.

## Response `200`

List a specific affiliation equal to and below the caller's affiliation.

- ResponseBase
  - `result` unknown, required
  - `success` boolean, required — Boolean indicating if the request was successful.
  - `errors` object[], required — An array of error messages (code and message)
    - `code` integer, required — Integer code denoting the type of error.
    - `message` string, required — An error message
  - `messages` object[], required — An array of information messages (code and message)
    - `code` integer, required — Integer code denoting the type of message.
    - `message` string, required — A more specific message.

---

[API](https://skmtc.dev/hyperledger/apis/fabric-ca-server-api.md) · [All operations](https://skmtc.dev/hyperledger/apis/fabric-ca-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperledger/fabric-ca-server-api/revisions/f1cf3d665f0e/schema)