Assert a relation
POST/v1/projects/:project_id/documents/:document_id/relations
Asserts a typed edge from this document to another in the same project. Asserting the same edge twice is 409: an edge is a fact, and the second assertion is the same fact.
Writing an edge is a write of the asserting document (documents:UpdateDocument); the document it points at is unchanged, which is what lets an agent record what its own report derives from without being able to make another report claim anything.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 413
- 429
- 500
- 502
- 4XX
The asserted relation
An undeclared type, a to_document_id that is not a document id, a document relating to itself, or a target in another project
Unauthorized
Forbidden
Either document was not found
That relation is already asserted
REQUEST_REJECTED — the request body is over the size the body parser accepts
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded
The deployment's admission service is asked about this write and did not answer — ADMISSION_UNAVAILABLE; the write did not happen
The deployment's admission service refused this write — answered under the service's own 4xx status, with its code (matching ^[A-Za-z_][A-Za-z0-9_]{0,63}$, not necessarily an ERROR_CODES key), message and meta; the write did not happen. A status this operation also declares on its own is documented there