Save issue decisions, tags and archive state if the read revision is still current
consoleSessionvg_session<token>The console's session cookie, set when you sign in. Every operation accepts it, at the role the operation names.
orgId*stringAuthorised orgId; the server must verify organisation/project ownership before any read.
1 <= lengthprojectId*stringAuthorised projectId; the server must verify organisation/project ownership before any read.
1 <= lengthissueId*stringStable issue rule identity within the named project.
application/json- body
Compare metadata and evidence revisions atomically. Omitted or null state preserves the decision, including regression; setting state explicitly acknowledges current evidence.
tags*array<>Normalized lowercase tags belonging to this immutable issue ID.
items <= 32archived*archivedReversible archive state. Does not delete evidence or resolve findings.
revision*revision0 <= value <= 9007199254740991evidenceRevision*evidenceRevision0 <= value <= 9007199254740991state?|Null or omitted preserves the existing decision without acknowledging new evidence.
"open""resolved""ignored"nullPersisted issue metadata with the new revision.
application/json- response
issueId*stringstate*string"open""resolved""ignored"regressed*booleandecidedAt*|Null when no explicit decision has been saved.
date-timeevidenceRevision*integer0 <= value <= 9007199254740991reviewedEvidenceRevision*integer0 <= value <= 9007199254740991tags*array<>Normalized lowercase tags belonging to this immutable issue ID.
items <= 32archived*booleanReversible archive state. Does not delete evidence or resolve findings.
revision*integer0 <= value <= 9007199254740991curl -X PUT 'https://example.com/api/v1/org/string/project/string/issues/string/metadata' \ -H 'Content-Type: application/json' \ -d '{ "tags": [ "string" ], "archived": true, "revision": 0, "evidenceRevision": 0}'{ "issueId": "string", "state": "open", "regressed": true, "decidedAt": "2019-08-24T14:15:22Z", "evidenceRevision": 0, "reviewedEvidenceRevision": 0, "tags": [ "string" ], "archived": true, "revision": 0}Was this page helpful?