Connect Widget

Create grant request

post

Creates a new GNAP grant request.

Header parameters

x-client-idstringRequired

detached-jwsstringRequired

Detached JSON Web Signature (JWS) token for request authentication and verification

Body

clientstringRequired

The client ID of the client requesting the access token.

providersone ofOptional

The providers enabled for the interaction - list or "production", "all", "sandbox"

Default: production

or

string · enumOptional

Provider category selection

Possible values:

networksone ofOptional

The network(s) desired. Query GET /networks for list of available networks.

Default: all

string[]Optional

Specific networks IDs (e.g. ["ETHEREUM", "SOLANA"])

or

string · enumOptional

Network category selection

Possible values:

Responses

201

Returns the created grant request details.

application/json

400

Bad request

post

HTTPcURLJavaScriptPython

POST /v1/grant HTTP/1.1
Host: auth.armory.playnarval.com
x-client-id: text
detached-jws: text
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "access_token": {
    "label": "text",
    "access": [
      {
        "type": "text",
        "actions": [
          "text"
        ],
        "locations": [
          "text"
        ]
      }
    ]
  },
  "client": "text",
  "user": {
    "id": "text"
  },
  "interact": {
    "start": [
      "text"
    ],
    "finish": {
      "method": "text",
      "uri": "text",
      "nonce": "text"
    }
  },
  "providers": "production",
  "capabilities": [
    "read_accounts"
  ],
  "networks": "all"
}

{
  "interact": {
    "redirect": "text",
    "finish": "text",
    "expires_in": 1
  },
  "continue": {
    "access_token": {
      "value": "text"
    },
    "uri": "text"
  }
}

Continue grant request

post

Continues an existing GNAP authorization process.

Header parameters

x-client-idstringRequired

authorizationstringRequired

detached-jwsstringRequired

Detached JSON Web Signature (JWS) token for request authentication and verification

Body

interact_refstringRequired

The interact_ref of the grant request

Responses

201

Returns the continued grant request details.

application/json

400

Bad request

post

HTTPcURLJavaScriptPython

POST /v1/continue HTTP/1.1
Host: auth.armory.playnarval.com
x-client-id: text
authorization: text
detached-jws: text
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "interact_ref": "text"
}

{
  "access_token": {
    "label": "text",
    "value": "text",
    "manage": {
      "uri": "text",
      "access_token": {
        "value": "text"
      }
    },
    "access": [
      {
        "type": "text",
        "actions": [
          "text"
        ],
        "locations": [
          "text"
        ],
        "identifier": "text"
      }
    ],
    "expires_in": 1
  }
}