Delete/archive wiki page when source file is deleted

[KevinGDialpad]

When foo.md is deleted, or renamed bar.md or moved to baz/qux.md, the original page should be deleted as well.

This is tricky because you don't really delete a page in Confluence - you archive it, then it can be deleted from the archive. There are several problems:

• the user may have permission to archive a page, but not to delete it
• if the file is added back later and the page is still in the archived state, the script will try to update it (since it already exists), but won't be able to (because an archived page is read-only)

[KevinGDialpad]

The Atlassian client doesn't have anything called archive_page or delete_page, so I looked at the API and found https://developer.atlassian.com/cloud/confluence/rest/v2/api-group-page/#api-pages-id-delete. But it returns 404, even though it can find the page:

import requests
from requests.auth import HTTPBasicAuth

url = '[REDACTED]'
email = '[REDACTED]'
token = '[REDACTED]'

auth = HTTPBasicAuth(email, token)

response = requests.request(
   "GET",
   url,
   auth=auth
)

print(response.text)

response = requests.request(
   "DELETE",
   url,
   auth=auth
)

print(response.text)

$ python test.py 
{"parentType":"page","ownerId":"'[REDACTED]'","createdAt":"'[REDACTED]'","authorId":"'[REDACTED]'","lastOwnerId":null,"position":'[REDACTED]',"version":{"number":2,"message":"","minorEdit":false,"authorId":"'[REDACTED]'","createdAt":"'[REDACTED]'"},"title":"'[REDACTED]'","status":"current","body":{},"parentId":"'[REDACTED]'","spaceId":"'[REDACTED]'","id":"'[REDACTED]'","_links":{"editui":"'[REDACTED]'","edituiv2":"'[REDACTED]'","tinyui":"'[REDACTED]'","base":"'[REDACTED]'"}}
{"errors":[{"status":404,"code":"NOT_FOUND","title":"Not Found","detail":null}]}

That's because Atlassian returns 403s as 404s:

So my user doesn't have permission to delete a page via the API, even though I can archive/unarchive pages from the UI.

[KevinGDialpad]

Looks like the v1 API had an endpoint to archive pages, but v2's Content API doesn't have that.

This ticket seems to be blocked on https://jira.atlassian.com/browse/CONFCLOUD-72078 / https://jira.atlassian.com/browse/CONFCLOUD-70330

[KevinGDialpad]

Both tickets have been marked as resolved, so we're ready for another try.