Skip to content
TasksMate Developers
App

0.x — pre-release, no compatibility promise yet.What this means

Revoke a refresh token or an access token (RFC 7009)

POST/oauth/revoke

Revoke a refresh token (its whole family and the connection’s access tokens) or an access token (RFC 7009).

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/x-www-form-urlencoded
RevokeRequest
object
token
required

A refresh token (tmr_…) or an access token (tm_live_…)

string
token_type_hint
string
Allowed values: refresh_token access_token
client_id

Required for a public app; a confidential app may send it with client_secret instead of HTTP Basic

string
client_secret

client_secret_post (or use HTTP Basic)

string

Responses

Section titled “ Responses ”

200

Section titled “200”

Revoked, or nothing to revoke (always 200 for a known app)

Media typeapplication/json
object

Example

{}

400

Section titled “400”

An OAuth error (invalid_request, invalid_grant, invalid_scope, unsupported_grant_type)

Media typeapplication/json
OAuthErrorBody

A OAuthErrorBody object.

object
error
required
Error

Invalid_request · invalid_client · invalid_grant · unauthorized_client · unsupported_grant_type · invalid_scope

string
error_description
Any of:
string

Example

{
  "error": "invalid_grant",
  "error_description": "string"
}

401

Section titled “401”

Client authentication failed (invalid_client)

Media typeapplication/json
OAuthErrorBody

A OAuthErrorBody object.

object
error
required
Error

Invalid_request · invalid_client · invalid_grant · unauthorized_client · unsupported_grant_type · invalid_scope

string
error_description
Any of:
string

Example

{
  "error": "invalid_grant",
  "error_description": "string"
}