Skip to content
GitmoapAPIBeta
Identity & platformlegal
GET/legal

The legal documents, the version of each in force and the one coming, and Gitmoap's means of contact

list_legal_documents
  • Public
    This operation declares no security requirement: it takes no token.
  • Cacheable · ref addressed

    x-gitmoap-cache: {"kind":"ref_addressed"}

  • Single-resource

    x-gitmoap-isolation: {"kind":"single_or_self_scoped"}

  • Conditional · 304
    Declares 304 Not Modified.

Every document with a published version — the Terms of Service, the policies and notices, and the Entity Details — and, for each, the version in force today and the version that will take its place, so a new version can be read before it binds. The contacts are Gitmoap's addresses and contact form as the Entity Details state them today, each with the contact-form topic that reaches the same desk. No sign-in is needed.

Responses

200The legal documents and the means of contactapplication/json
  • contact_languagesstringThe languages the points of contact answer in.
  • contactsarray of LegalContactThe means of contact, as the Entity Details state them today.
    • The LegalContact schema
    • deskLegalContactDesksupportcontact_formnoticesprivacy_requestsreports_of_illegal_contentsecurity_disclosuresdsa_authoritiesdsa_recipientsWhich desk it is.
    • kindLegalContactKindemailurlWhether it is an email address or a page.
    • labelstringWhat the Entity Details call it.
    • valuestringThe address, or the page.
    • topicContactTopicsupportprivacylegalabusesecurityor nulloptionalThe contact-form topic that reaches the same desk, when there is one.
  • documentsarray of LegalDocumentEntryEvery document with a published version. Empty until the first publication.
    • The LegalDocumentEntry schema
    • document_keyLegalDocumentKeyterms-of-serviceacceptable-use-policycontent-reporting-policysecurity-disclosure-policyprivacy-statementcookie-statementdata-processing-addendumsubprocessorsentityThe document.
    • kindLegalDocumentKindagreementpolicynoticeaddendumannexWhat it is.
    • titlestringIts title.
    • currentLegalVersionSummary or nulloptionalThe version in force today, or none when its first version has yet to take effect.
      • The LegalVersionSummary schema
      • content_sha256stringThe SHA-256 of its text, as the published body hashes.
      • effective_dateCalendarDate (string)The day it takes effect, in UTC.
      • versionLegalVersion (string)The version.
      • change_summarystring or nulloptionalWhat changed since the version before it, as its publisher summarised it. None for a first version.
    • upcomingLegalVersionSummary or nulloptionalThe version that will next take the place of the current one, when one is published.
      • The LegalVersionSummary schema
      • content_sha256stringThe SHA-256 of its text, as the published body hashes.
      • effective_dateCalendarDate (string)The day it takes effect, in UTC.
      • versionLegalVersion (string)The version.
      • change_summarystring or nulloptionalWhat changed since the version before it, as its publisher summarised it. None for a first version.
  • stageLegalServiceStagebetagenerally_availableThe stage Gitmoap is at, as the Terms of Service in force state it: beta until a version of the Terms says it has left the Beta.
200 exampleSynthesized example
{
"contact_languages": "contact-languages-7933",
"contacts": [
{
"desk": "support",
"kind": "email",
"label": "label-d110",
"value": "value-1dcf"
}
],
"documents": [
{
"document_key": "terms-of-service",
"kind": "agreement",
"title": "Draw the region map from operation density"
},
{
"document_key": "terms-of-service",
"kind": "agreement",
"title": "Inline scalar newtypes but keep their brand"
}
],
"stage": "beta"
}
304Nothing changed since the caller's `If-None-Match`

No body.

CLI

gitmoap legal list