Connect links
Revoke a connect link
DELETE
https://hivepost.app/v1/connect-links/{id}The link stops working now. Only open links can be revoked; revoking twice is fine.
Path
idstringRequired
Returns
200 The link, now `revoked`.
Errors
| Status | Code | When |
|---|---|---|
| 401 | unauthorized | No API key, or one that isn't valid (unauthorized). |
| 403 | forbidden, drafts_only, network_not_available | The key can't do this (forbidden, drafts_only), or the network isn't open in the API (network_not_available). |
| 404 | not_found | Nothing with that id (not_found). |
| 422 | validation_failed, return_url_not_allowed, account_not_connected, text_too_long, media_required, time_in_past | A field is wrong (validation_failed), a connect link's return_url isn't on an allowed domain (return_url_not_allowed), an account needs reconnecting (account_not_connected), or a network refuses the post as it is (e.g. text_too_long, media_required, time_in_past). details lists each problem with the account it is about. |
| 429 | rate_limited | More than 60 requests in a minute (rate_limited). |
| 500 | internal_error | Something went wrong on our side (internal_error). Safe to retry with the same Idempotency-Key. |