Create TnC
POST/references/termsandconditions
creates a new terms and conditions object available to be signed by organisation admins on the directory
Request
Header Parameters
Possible values: Value must match regular expression ^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2} (Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2} (GMT|UTC)$
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
The PSU's IP address if the PSU is currently logged in with the TPP.
An RFC4122 UID used as a correlation id.
Indicates the user-agent that the PSU is using.
- application/json
Body
required
TnC create request
ExternalSigningService
object
Possible values: [DocuSign
]
The Name of the External Signing Service
ExternalSigningServiceSignerTemplateConfig
object
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 1 signer
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 2 signers
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 3 signers
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 4 signers
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 5 signers
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 6 signers
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The Subject of the External Signing Service
Possible values: non-empty
and <= 100 characters
, Value must match regular expression ^[^<>]*$
The Subject of the Email for External Signing Service
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The Name of the TnC
Possible values: [Participant
, Directory
]
Role for which this TnC applies
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The MarkDown of the TnC
Possible values: [Active
, Inactive
]
Default value: Active
Current status of this resource
Responses
- 201
- 400
- 401
- 403
- 409
- 429
- 500
- 502
- 504
Details of the TnC item
Response Headers
x-fapi-interaction-id
string
- application/json
- Schema
- Example (from schema)
Schema
ExternalSigningService
object
Possible values: [DocuSign
]
The Name of the External Signing Service
ExternalSigningServiceSignerTemplateConfig
object
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 1 signer
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 2 signers
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 3 signers
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 4 signers
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 5 signers
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
Template ID for 6 signers
Version of the TnC document
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The Subject of the External Signing Service
Possible values: non-empty
and <= 100 characters
, Value must match regular expression ^[^<>]*$
The Subject of the Email for External Signing Service
Version of the TnC
Unique identifier for the Terms and Conditions Item
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The Name of the TnC
Possible values: [Participant
, Directory
]
Role for which this TnC applies
Possible values: non-empty
, Value must match regular expression ^[^<>]*$
The MarkDown of the TnC
Possible values: [Active
, Inactive
]
Default value: Active
Current status of this resource
{
"ExternalSigningService": {
"ExternalSigningServiceName": "DocuSign",
"ExternalSigningServiceSignerTemplateConfig": {
"Signer1TemplateId": "string",
"Signer1Version": 0,
"Signer2TemplateId": "string",
"Signer2Version": 0,
"Signer3TemplateId": "string",
"Signer3Version": 0,
"Signer4TemplateId": "string",
"Signer4Version": 0,
"Signer5TemplateId": "string",
"Signer5Version": 0,
"Signer6TemplateId": "string",
"Signer6Version": 0
},
"ExternalSigningServiceSubject": "string",
"ExternalSigningServiceEmailSubject": "string"
},
"Version": 0,
"TnCId": 0,
"Name": "string",
"Type": "Participant",
"Content": "string",
"Status": "Active"
}
Bad Request
Response Headers
x-fapi-interaction-id
string
- application/json
- Schema
- Example (from schema)
Schema
Validation Error messages
{
"errors": [
"string"
]
}
Unauthorized
Response Headers
x-fapi-interaction-id
string
Forbidden
Response Headers
x-fapi-interaction-id
string
Conflict
Response Headers
x-fapi-interaction-id
string
Too many requests, maximum capacity reached. Requests are now throttled.
Response Headers
x-fapi-interaction-id
string
Internal Server Error
Response Headers
x-fapi-interaction-id
string
Bad Gateway
Response Headers
x-fapi-interaction-id
string
Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.
Response Headers
x-fapi-interaction-id
string