Questionnaire Responses

Create a certificate on the company an answer request is about

Changed on

Creates a certificate as the answer to a CERTIFICATE question, on the company the request is about. The target company comes from the request's onBehalfOfCompanyId and is deliberately not accepted in the body. Only the answering company may call it, and only while the brand that issued the request is still connected to it; anyone else gets 404 request_not_found. Replaces POST /v3/claims for this flow, which inserted the claim and copied its file into private storage and then read the row back through a network-scoped query — so a delegated answering party got a 404 after the write, leaving a claim no read path can see, and a duplicate check scoped to the caller that could not find it, so every retry wrote another. Here the read-back is unscoped and the duplicate check is scoped to the company the certificate is actually filed on. The certificate is created in REQUESTED state; status is not client-settable. Required and optional fields mirror POST /api/claims, so only the standard and the two dates are required; a file is optional and, when given, must belong to the caller. A standardId that names no standard or certification answers 400 invalid_standard_id and writes nothing. Responds 201. A request whose questionnaire is archived is read-only and answers 409 questionnaire_archived.

post/api/questionnaires/requests/{requestId}/certificates

Request

  • Base URL
    https://api.retraced.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.retraced.com/api/questionnaires/requests/{requestId}/certificates
  • Auth
    none declared

Path parameters

requestIdstring required

Request body

standardIdstring required
issueDatestring required
expirationDatestring required
fileIdstring nullable
issuedBystring nullable
documentNumberstring nullable
licenseNumberstring nullable
explanationstring nullable

Response

Default Response

Changes

  • 97e51f27dc77Revision changes
    • breaking

      request property list-of-types was narrowed by removing types null from media type application/json

    • breaking

      request property list-of-types was narrowed by removing types null from media type application/json

    • breaking

      request property list-of-types was narrowed by removing types null from media type application/json

    • breaking

      request property list-of-types was narrowed by removing types null from media type application/json

    • breaking

      request property list-of-types was narrowed by removing types null from media type application/json

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • warning

      the request property's maxLength was set to 255

    • warning

      the request property's maxLength was set to 36

    • warning

      the request property's maxLength was set to 255

    • warning

      the request property's maxLength was set to 255

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      the request property became nullable

    • info

      response property data/companyId list-of-types was narrowed by removing types null from media type application/json of response 201

    • info

      response property data/standardId list-of-types was narrowed by removing types null from media type application/json of response 201

  • d1450ba9a75aRevision changes
    • info

      endpoint added