Update the given certification

PUT /organisations/{OrganisationId}/softwarestatements/{SoftwareStatementId}/certifications/{SoftwareStatementCertificationId}

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

    Format should match the following pattern: ^(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)$.

  • 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.

Path parameters

  • OrganisationId string Required

    The organisation ID

    Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

  • SoftwareStatementId string Required

    The software statement ID

    Maximum length is 40. Format should match the following pattern: ^[^<>]*$.

  • SoftwareStatementCertificationId string Required

    Software Statement certification Id

    Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

application/json

Body Required

  • CertificationStartDate string Required

    Maximum length is 10. Format should match the following pattern: ^[0-3][0-9]/[0-1][0-9]/2([0-9]{3})$.

  • CertificationStatus string Required

    The different types of certification status

    Values are Awaiting Certification, Certified, Deprecated, Rejected, Warning, or Self-Certified. Default value is Awaiting Certification.

  • CertificationURI string(uri) Required

    Maximum length is 500. Format should match the following pattern: ^(https://).*.

  • ProfileType string Required

    Certification type

    Format should match the following pattern: ^[^<>]*$.

  • ProfileVariant string Required

    Certification variant

    Format should match the following pattern: ^[^<>]*$.

  • ProfileVersion number Required

    The version number of the certification

  • Status string

    Current status of this resource

    Values are Active or Inactive. Default value is Active.

Responses

  • 200 application/json

    Software Statement certification for the given certification id

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attributes Show response attributes object
    • CertificationExpirationDate string

      JSONDatetime of certification expiration date

      Format should match the following pattern: ^[^<>]*$.

    • CertificationId string

      Unique ID associated with the software statement certification

      Minimum length is 1, maximum length is 40. Format should match the following pattern: ^[^<>]*$.

    • CertificationStartDate string

      JSONDatetime of certification start date

      Format should match the following pattern: ^[0-3][0-9]/[0-1][0-9]/2([0-9]{3})$.

    • CertificationStatus string

      The different types of certification status

      Values are Awaiting Certification, Certified, Deprecated, Rejected, Warning, or Self-Certified. Default value is Awaiting Certification.

    • CertificationURI string(uri)

      Maximum length is 500. Format should match the following pattern: ^(https://).*.

    • ProfileType string

      Certification type

      Format should match the following pattern: ^[^<>]*$.

    • ProfileVariant string

      Certification variant

      Format should match the following pattern: ^[^<>]*$.

    • ProfileVersion number

      The version number of the certification

    • SoftwareStatementId string

      Unique Software Statement Id

      Maximum length is 40. Format should match the following pattern: ^[^<>]*$.

    • Status string

      Current status of this resource

      Values are Active or Inactive. Default value is Active.

  • 400 application/json

    Bad Request

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attribute Show response attribute object
    • errors array[string]

      Validation Error messages

  • 401

    Unauthorized

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 403

    Forbidden

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 404 application/json

    Not found

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

    Hide response attribute Show response attribute object
    • errors array[string]

      Validation Error messages

  • 429

    Too many requests, maximum capacity reached. Requests are now throttled.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 500

    Internal Server Error

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 502

    Bad Gateway

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

  • 504

    Upstream timeout, insufficient capacity to serve request. More capacity being brought online. Please try again.

    Hide headers attribute Show headers attribute
    • x-fapi-interaction-id string

      An RFC4122 UID used as a correlation id.

      Minimum length is 1, maximum length is 100. Format should match the following pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-]{0,99}$.

PUT /organisations/{OrganisationId}/softwarestatements/{SoftwareStatementId}/certifications/{SoftwareStatementCertificationId}
curl \
 --request PUT 'https://matls-api.sandbox.raidiam.io/organisations/{OrganisationId}/softwarestatements/{SoftwareStatementId}/certifications/{SoftwareStatementCertificationId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "x-fapi-auth-date: string" \
 --header "x-fapi-customer-ip-address: string" \
 --header "x-fapi-interaction-id: string" \
 --header "x-customer-user-agent: string" \
 --data '{"CertificationStartDate":"string","CertificationStatus":"Awaiting Certification","CertificationURI":"https://example.com","ProfileType":"Redirect","ProfileVariant":"FAPI Adv. OP w/ MTLS","ProfileVersion":42.0,"Status":"Active"}'
Request examples
# Headers
x-fapi-auth-date: string
x-fapi-customer-ip-address: string
x-fapi-interaction-id: string
x-customer-user-agent: string

# Payload
{
  "CertificationStartDate": "string",
  "CertificationStatus": "Awaiting Certification",
  "CertificationURI": "https://example.com",
  "ProfileType": "Redirect",
  "ProfileVariant": "FAPI Adv. OP w/ MTLS",
  "ProfileVersion": 42.0,
  "Status": "Active"
}
Response examples (200)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "CertificationExpirationDate": "string",
  "CertificationId": "string",
  "CertificationStartDate": "string",
  "CertificationStatus": "Awaiting Certification",
  "CertificationURI": "https://example.com",
  "ProfileType": "Redirect",
  "ProfileVariant": "FAPI Adv. OP w/ MTLS",
  "ProfileVersion": 42.0,
  "SoftwareStatementId": "string",
  "Status": "Active"
}
Response examples (400)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}
Response examples (404)
# Headers
x-fapi-interaction-id: 73cac523-d3ae-2289-b106-330a6218710d

# Payload
{
  "errors": [
    "string"
  ]
}