Get Auth Token Metadata

APIs & SDKs

GET/__remote/api.vercel.com/v5/user/tokens/{tokenId}

Retrieve metadata about an authentication token belonging to the currently authenticated User.

Request

import { Edgenivo } from "@vercel/sdk";

const vercel = new Edgenivo({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.authentication.getAuthToken({
    tokenId: "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
  });

  console.log(result);
}

run();

Response

{
  "token": {
    "activeAt": "1632816536002",
    "createdAt": "1632816536002",
    "expiresAt": "1632816536002",
    "id": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
    "leakedAt": "1632816536002",
    "leakedUrl": "https://example.com",
    "name": "Example Name",
    "origin": "github",
    "prefix": "vcp_",
    "revokedAt": "1632816536002",
    "scopes": [
      {
        "createdAt": "123",
        "expiresAt": "123",
        "origin": "app",
        "sudo": {
          "expiresAt": "123",
          "origin": "email-otp",
          "verifiedAt": "123"
        },
        "type": "user"
      }
    ],
    "suffix": "abc123",
    "type": "oauth2-token"
  }
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

tokenIdstringRequired

The identifier of the token to retrieve. The special value "current" may be supplied, which returns the metadata for the token that the current HTTP request is authenticated with.

Response

200Successful response.

tokenobjectRequired

Authentication token metadata.

Errors

400One of the provided values in the request query is invalid.

401Error

403You do not have permission to access this resource.

404Token not found with the requested `tokenId`.

410Error

Request

import { Edgenivo } from "@vercel/sdk";

const vercel = new Edgenivo({
  bearerToken: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await vercel.authentication.getAuthToken({
    tokenId: "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
  });

  console.log(result);
}

run();

Response

{
  "token": {
    "activeAt": "1632816536002",
    "createdAt": "1632816536002",
    "expiresAt": "1632816536002",
    "id": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
    "leakedAt": "1632816536002",
    "leakedUrl": "https://example.com",
    "name": "Example Name",
    "origin": "github",
    "prefix": "vcp_",
    "revokedAt": "1632816536002",
    "scopes": [
      {
        "createdAt": "123",
        "expiresAt": "123",
        "origin": "app",
        "sudo": {
          "expiresAt": "123",
          "origin": "email-otp",
          "verifiedAt": "123"
        },
        "type": "user"
      }
    ],
    "suffix": "abc123",
    "type": "oauth2-token"
  }
}

OpenAPI Specification