Skip to main content
POST
/
card
cURL
curl --request POST \
  --url https://development.knotapi.com/card \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "task_id": "123456",
  "jwe": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLC...",
  "user": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLC...",
  "card": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLC..."
}'
{
  "message": "Success"
}
See code samples here for how to structure and encrypt the JWE in various programming languages.
Receiving a successful response from this endpoint means your request has passed validations, including for the jwe.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.

Body

application/json

The input parameters required for switching a card.

​
task_id
string
required

task_id value provided in the AUTHENTICATED webhook.

Example:

"123456"

​
jwe
string
required

JWE value.

Example:

"eyJhbGciOiJSU0EtT0FFUC0yNTYiLC..."

​
user
string
deprecated

User object encrypted in a JWE. Created using the public key retrieved from Retrieve JWK

Example:

"eyJhbGciOiJSU0EtT0FFUC0yNTYiLC..."

​
card
string
deprecated

Card object encrypted in a JWE. Created using the public key retrieved from Retrieve JWK

Example:

"eyJhbGciOiJSU0EtT0FFUC0yNTYiLC..."

Response

Successful request. Receiving this response means your request has passed validations, including the jwe.

​
message
string

Success message.

Example:

"Success"