PerspecTaskPerspecTask

Unlink a pull request from a task

Remove a link (`prId` is the `id` from the list). It stays unlinked: later pushes to the PR do not link it again, only linking it by URL does.

DELETE
/tasks/{id}/pull-requests/{prId}

Remove a link (prId is the id from the list). It stays unlinked: later pushes to the PR do not link it again, only linking it by URL does.

Authorization

bearerAuth
AuthorizationBearer <token>

Your PerspecTask API key (starts with pt_live_). Each key carries scopes: tasks:read (GET), tasks:write (full create/update), and tasks:write:meta (create/update everything EXCEPT editing title/description of existing tasks — for automation that manages workflow without rewriting human-authored content).

In: header

Path Parameters

id*string
prId*string

The link id (id from the pull request list).

Response Body

curl -X DELETE "https://example.com/tasks/string/pull-requests/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
Empty
Empty

Link a pull request to a task POST

Link a PR by its URL. Usually unnecessary: a PR whose title, branch or description contains the task's `pr_token` links itself. Linking an already-linked PR refreshes it. Needs the PerspecTask GitHub app installed on the repository (Account → GitHub in the web app). Answers 404 with `code: "not_installed"` when the app isn't on that repository or your GitHub account can't read it.