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 '
{
  "jwe": "eyJhbGciOiJSU0EtT0FFUC0yNTYiLC...",
  "task_id": "123456"
}
'
{
  "message": "Success"
}

Documentation Index

Fetch the complete documentation index at: https://docs.knotapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
jwe
string
required

JWE value.

Example:

"eyJhbGciOiJSU0EtT0FFUC0yNTYiLC..."

​
task_id
string
required

task_id value provided in the AUTHENTICATED webhook.

Example:

"123456"

Response

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

​
message
string

Success message.

Example:

"Success"