# Create TnC

**POST /references/termsandconditions**




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


## Authentication methods
- O auth


## Parameters
#### Headers
- **x-fapi-auth-date** (string)
  The time when the PSU last logged in with the TPP. 
All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: 
Sun, 10 Sep 2017 19:43:31 UTC
- **x-fapi-customer-ip-address** (string)
  The PSU's IP address if the PSU is currently logged in with the TPP.
- **x-fapi-interaction-id** (string)
  An RFC4122 UID used as a correlation id.
- **x-customer-user-agent** (string)
  Indicates the user-agent that the PSU is using.



## Body parameters
Content-type: application/json

- **ExternalSigningService** (object)
  
- **Content** (string)
  The MarkDown of the TnC
- **Name** (string)
  The Name of the TnC
- **RoleIds** (array[string(uuid)])
  Array of Unique identifiers for the Authorisation Domain Roles the Terms and Conditions Item is linked to
- **Status** (string)
  Current status of this resource
- **Type** (string)
  Role for which this TnC applies

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

#### Body Parameters: application/json (object)
- **ExternalSigningService** (object)
  
- **Version** (integer)
  Version of the TnC
- **Content** (string)
  The MarkDown of the TnC
- **Name** (string)
  The Name of the TnC
- **RoleIds** (array[string(uuid)])
  Array of Unique identifiers for the Authorisation Domain Roles the Terms and Conditions Item is linked to
- **Status** (string)
  Current status of this resource
- **TnCId** (integer)
  Unique identifier for the Terms and Conditions Item
- **Type** (string)
  Role for which this TnC applies

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

#### Body Parameters: 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.

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

### 429: Too many requests, maximum capacity reached. Requests are now throttled.
#### 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)