Questionnaire Responses

Create an audit on the company an answer request is about

Changed on

Creates an audit as the answer to an AUDIT question, on the company the request is about. The target company comes from the request's onBehalfOfCompanyId and is 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. Unlike POST /api/audits, the audit is then shared with the subject company and with the brand without requiring the sharer to be linked to them — the request is the authorization — so the factory can finally see its own audit. Through the generic endpoint that share needed an answering-party-to-subject connection, which a delegated party never has, so it threw and was swallowed. isPublic is not accepted and is always false: a public audit fans a read grant out to every company linked to the uploader, which would expose the subject company's audit to the answering party's entire network. A failed share is reported, not logged and forgotten. A request whose questionnaire is archived is read-only and answers 409 questionnaire_archived.

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

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}/audits
  • Auth
    none declared

Path parameters

requestIdstring required

Request body

auditTypeIdstring required
auditDatestring nullable
nextPlannedAuditDatestring nullable
auditedBystring nullable
facilityScorestring nullable
referenceNumberstring nullable
auditReportFileIdstring nullable
correctiveActionPlanFileIdstring nullable

Response

Default Response

Changes

  • 52053c64373eRevision changes
    • info

      added the non-success response with the status

  • 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

      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 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 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 64

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

    • warning

      the request property's maxLength was set to 255

    • warning

      the request property's maxLength was set to 64

    • 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

      the request property became nullable

    • info

      the request property became nullable

    • info

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

    • info

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