GET/documents/{documentId}/attribution
Get document edit attribution
Operation documents.attribution.get
Description
Returns which writer first uploaded each stretch of a document's history, derived from the signed write headers of its stored updates; it is not proof of authorship. Requires read access. Responses carry an ETag, so a client that sends If-None-Match gets 304 when nothing changed; long histories are truncated here and paged through the attribution ranges route.
Authentication
Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.
Parameters
| Name | In | Type | Details |
|---|---|---|---|
documentId | path | string | required |
accept-encoding | header | string | optional |
if-none-match | header | string | optional |
Responses
200 OK
application/jsonDocumentEditAttributionResponse
Who first uploaded each part of a document, as compact runs derived from the signed write headers of its updates.
4 fields
attributionRevisionintegerrequired- at least 0
Changes whenever new updates change the attribution.
documentIdstringrequired- not empty
truncatedbooleanoptionalTrue when the run list hit the response limit; page the rest through the ranges route.
Other fields are allowed.
Response headers
| Name | Type | Details |
|---|---|---|
cache-control | string | required
|
content-encoding | string | optional |
content-type | string | required
|
etag | string | required
|
vary | string | required
|
304 Not Modified
No body.
Response headers
| Name | Type | Details |
|---|---|---|
cache-control | string | required
|
etag | string | required
|
vary | string | required
|
Other responses
| Status | Meaning | Body |
|---|---|---|
| 400 | Bad Request |
|
| 401 | Unauthorized |
|
| 403 | Forbidden |
|
| 404 | Not Found |
|
| 409 | Conflict |
|
| 500 | Internal Server Error |
|
| 503 | Service Unavailable |
|
Additional rules
The server also enforces these rules, which the schema above cannot express.
Document attribution segment start counters are less than end counters.