Accept Ivora's terms for a team

Path parameters

• team_idstringRequired
  Pattern ^team_[0-9a-f]{32}$

Request body

• documentsarray of TermsAcceptItemRequired
  The documents the owner read and accepts.
  Child attributes

  • documentenumRequired
    terms_of_service (Ivora's Terms of Service) or dpa (the data processing addendum).
    One of terms_of_service, dpa
  • standard_terms_versionstringRequired
    The Standard Terms version shown to the owner (GET /v1/legal/terms).
    1–16 characters · Pattern ^[0-9]+(\.[0-9]+)*$
  • cover_page_versionstringRequired
    The cover page version shown to the owner (GET /v1/legal/terms).
    Up to 32 characters · Pattern ^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$

Returns · 200

• team_idstringRequired
• acceptedbooleanRequired
  Whether the team accepted the current version of every document. Self-serve CSMS access needs it.
• missingarray of enumRequired
  The documents whose current version the team has not accepted: show them to an owner to accept.
• documentsarray of TermsDocumentStatusRequired
  Child attributes

  • documentenumRequired
    terms_of_service (Ivora's Terms of Service) or dpa (the data processing addendum).
    One of terms_of_service, dpa
  • titlestringRequired
  • standard_termsStandardTermsRequired
    Child attributes

    • namestringRequired
      Common Paper Cloud Service Agreement Standard Terms, or Common Paper DPA Standard Terms.
    • versionstringRequired
      The Common Paper Standard Terms version the cover page incorporates (2.1 for the Terms of Service, 1.1 for the DPA).
    • urlstringRequired
      Where Common Paper hosts this version of the Standard Terms. Link it next to the cover page.
    • licensestringRequired
      CC BY 4.0.
    • license_urlstringRequired
    • attributionstringRequired
      The attribution to show with the Standard Terms.
  • cover_page_versionstringRequired
    The Ivora Cover Page version (semver). A new major or minor version, or new Standard Terms, must be accepted again; a patch need not.
  • effectivestringRequired
    The date the version takes effect (YYYY-MM-DD).
  • sha256stringRequired
    SHA-256 of the cover page body, recorded with each acceptance: the exact text accepted.
  • draftbooleanRequired
    true while the cover page still holds [LEGAL TEXT] placeholders for Ivora to fill in.
  • acceptedobject | nullRequired
    The team's acceptance of the current version (an earlier patch of the same cover page counts); null until an owner accepts it.
    Child attributes

    • idstringRequired
    • documentenumRequired
      terms_of_service (Ivora's Terms of Service) or dpa (the data processing addendum).
      One of terms_of_service, dpa
    • standard_terms_versionstringRequired
      The Common Paper Standard Terms version accepted.
    • cover_page_versionstringRequired
      The Ivora Cover Page version accepted.
    • sha256stringRequired
      SHA-256 of the cover page text accepted.
    • accepted_atstringRequired
    • accepted_byAcceptedByRequired
      Child attributes

      • user_idstringRequired
      • emailstring | null
      • rolestringRequired
        The person's team role when they accepted (always owner).
    • ipstring | null
      The client address of the acceptance; shown to the team's owners and admins and to Ivora staff only.
    • user_agentstring | null
      The browser's user agent (first 300 characters); shown as ip is.
• historyarray of TermsAcceptanceRequired
  Every acceptance of the team, newest first, earlier versions included.
  Child attributes

  • idstringRequired
  • documentenumRequired
    terms_of_service (Ivora's Terms of Service) or dpa (the data processing addendum).
    One of terms_of_service, dpa
  • standard_terms_versionstringRequired
    The Common Paper Standard Terms version accepted.
  • cover_page_versionstringRequired
    The Ivora Cover Page version accepted.
  • sha256stringRequired
    SHA-256 of the cover page text accepted.
  • accepted_atstringRequired
  • accepted_byAcceptedByRequired
    Child attributes

    • user_idstringRequired
    • emailstring | null
    • rolestringRequired
      The person's team role when they accepted (always owner).
  • ipstring | null
    The client address of the acceptance; shown to the team's owners and admins and to Ivora staff only.
  • user_agentstring | null
    The browser's user agent (first 300 characters); shown as ip is.
• outcomeenumRequired
  unchanged: the team had already accepted these versions; the first record stands.
  One of accepted, unchanged

Errors