# Create a new federation

**POST /references/federations**




## Servers
- Raidiam Directory Sandbox Environment: https://matls-api.sandbox.raidiam.io (Raidiam Directory Sandbox Environment)


## Authentication methods
- O auth


## Parameters



### Body: application/json (object)

- **Contacts** (array[string])
  The contacts of the federation
- **Description** (string)
  The description of the federation
- **HomepageUri** (string)
  The homepage uri of the federation
- **LogoUri** (string)
  The logo uri of the federation
- **Name** (string)
  The name of the federation
- **OrganizationName** (string)
  The organization name of the federation
- **PolicyUri** (string)
  The policy uri of the federation
- **RemoteTrustAnchor** (array[string(uri)])
  The uri for a remote trust anchor
- **Status** (string)
  Current status of this resource


## Responses
### 201
Details of the federation item
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **Contacts** (array[string])
  The contacts of the federation
- **CreatedAt** (string(date-time))

- **Description** (string)
  The description of the federation
- **FederationFetchEndpoint** (string(uri))
  The fetch endpoint of the federation
- **FederationListEndpoint** (string(uri))
  The list endpoint of the federation
- **FederationResolveEndpoint** (string(uri))
  The resolve endpoint of the federation
- **FederationTrustMarkListEndpoint** (string(uri))
  The trust mark list endpoint of the federation
- **FederationTrustMarkStatusEndpoint** (string(uri))
  The trust mark status endpoint of the federation
- **HomepageUri** (string)
  The homepage uri of the federation
- **LogoUri** (string)
  The logo uri of the federation
- **Name** (string)
  The name of the federation
- **OrganizationName** (string)
  The organization name of the federation
- **PolicyUri** (string)
  The policy uri of the federation
- **ReferenceID** (string(uuid))
  The ID of the federation
- **RemoteTrustAnchor** (array[string(uri)])
  The uri for a remote trust anchor
- **Status** (string)
  Current status of this resource

### 400
Bad Request
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **errors** (array[string])
  Validation Error messages

### 401
Unauthorized
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 403
Forbidden
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 404
Not found
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

#### Body: application/json (object)
- **errors** (array[string])
  Validation Error messages

### 409
Conflict
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 500
Internal Server Error
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 502
Bad Gateway
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.

### 504
Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
#### Headers
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.


[Powered by Bump.sh](https://bump.sh)