1. Card Art
Kobble
  • Introduction
  • API Fundamentals
    • Idempotency
    • Rate Limits
    • Healthcheck
      GET
  • Authorization
    • Authorization
    • Get access token
      POST
    • Get access token
      POST
  • Beneficiaries
    • List all beneficiaries
      GET
    • Get beneficiary by ID
      GET
    • Create beneficiary
      POST
    • Update beneficiary
      PUT
    • Create Payid beneficiary
      POST
  • Cards
    • Cards API
    • Card Creation Flow — Developer Guide & Onboarding
    • Get all cards
      GET
    • Create a new card
      POST
    • Get card by ID
      GET
    • Update card status
      PATCH
    • Replace or renew card
      POST
    • Generate card secret
      POST
    • Generate MeaWallet widget session token
      POST
  • Card Programs
    • Card Programs API
    • Get all programs
    • Create a new program
    • Get program by ID
  • Clients
    • Clients API
    • Get all clients
    • Get client by ID
    • Create a new client
    • Update client status
  • Endusers
    • Endusers API
    • Usage of Metadata on Endusers
    • Get all endusers
    • Create a new enduser
    • Get enduser by ID
    • Update enduser
  • Transactions
    • Transactions API
    • Get all transactions
    • Create a transaction
    • Get transaction by ID
    • Create manual credit transaction
    • Create manual debit transaction
  • Wallets
    • Wallets API
    • Get all wallets
    • Create a new wallet
    • Get wallet by ID
    • Update wallet
  • Relays
    • Relays API
    • Create subscription
  • Webhooks
    • Webhooks API
    • Webhook Signature Verification
    • Get all webhooks
    • Create a webhook
    • Delete a webhook
    • Report completed
  • Wallet Statements
    • Request a wallet statement
    • List wallet statements
    • Get a wallet statement
    • Get a wallet statement download URL
  • Card Art
    • Get a card art upload URL
      POST
    • Register a card art
      POST
    • List card arts
      GET
    • Get a card art
      GET
    • Update a card art
      PATCH
    • Activate a card art
      POST
    • Archive a card art
      POST
  • Schemas
    • Schemas
    • CardWidgetSessionTokenResponse
    • 202 Accepted
    • Webhook
    • 201 Created
    • Relay
    • Create Beneficiary with bank details
    • Client
    • Beneficiary
    • Card
    • CardCreateInputDto
    • CardStatusUpdateDto
    • CardRenewReplaceInputDto
    • Program
    • MetadataKobbleDebit1
    • ProgramCreateInputDto
    • Person
    • Company
    • Enduser
    • Enduser Create Person Input
    • Enduser Create Company Input
    • Metadata
    • Enduser Create Input DTO
    • Transaction
    • TransactionCreateManualCreditInputDto
    • TransactionCreateInputDto
    • Wallet
    • WalletCreateInputDto
    • WalletUpdateInputDto
    • WalletStatement
    • WebhookNotification
    • ReportCompletedEntity
    • ReportCompletedNotification
    • CardArt
    • CardArtDetail
    • CardArtUploadUrlInput
    • CardArtUploadUrlResponse
    • CardArtCreateInput
    • CardArtPatchInput
  1. Card Art

Register a card art

POST
/customers/v1/card-programs/{programId}/card-arts
Register a previously uploaded card art asset (created in DRAFT status). Requires the administrator/write scope.

Request

Path Params

Header Params

Body Params application/json

Example
{
    "card_art_id": "8f14e45f-ceea-467d-9a3a-2e1b9c0d1f23",
    "name": "Blue gradient",
    "type": "DIGITAL",
    "s3_key": "3712bf11/1b8ecc17/8f14e45f/card-front.png",
    "s3_bucket": "kobble-card-artworks",
    "content_type": "image/png",
    "width": 1024,
    "height": 645,
    "file_size": 248321,
    "checksum": "9e107d9d372bb6826bd81d3542a419d6",
    "metadata": {}
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/customers/v1/card-programs//card-arts' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
    "card_art_id": "8f14e45f-ceea-467d-9a3a-2e1b9c0d1f23",
    "name": "Blue gradient",
    "type": "DIGITAL",
    "s3_key": "3712bf11/1b8ecc17/8f14e45f/card-front.png",
    "s3_bucket": "kobble-card-artworks",
    "content_type": "image/png",
    "width": 1024,
    "height": 645,
    "file_size": 248321,
    "checksum": "9e107d9d372bb6826bd81d3542a419d6",
    "metadata": {}
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "program_id": "70c1146b-e933-4cb2-a789-bbca5312b517",
    "name": "string",
    "type": "DIGITAL",
    "status": "DRAFT",
    "s3_key": "string",
    "s3_bucket": "string",
    "content_type": "string",
    "width": 0,
    "height": 0,
    "file_size": 0,
    "checksum": "string",
    "metadata": {},
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}
Modified at 2026-07-10 06:55:15
Previous
Get a card art upload URL
Next
List card arts
Built with