Update one

patch

https://api.cardda.com/v1/card_issuing_requests/{card_issuing_request_id}

Updates a card issuing request. The owner, a manager, or an admin may edit the
base fields.

Certain fields are role-gated and, if present without the required role, the
whole request is rejected with 401:

user_id, company_id, budget_cents, budget_currency → require the
caller to act as a manager (admin or card_issuing_requests_manage).
tracking_number, tracking_url, estimated_delivery_date, and the
milestone timestamps printing_at / sent_at / delivered_at →
Cardda staff-only.
status is only permitted for admins.

physical cannot be changed after creation, and shipping fields cannot be
blanked on physical CLP requests (model validations → 422).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

card_issuing_request_id

uuid

required

UUID of the card issuing request.

Body Params

Payload to update a card issuing request. The cardholder (or a manager with the
card_issuing_requests_manage permission / an admin) may edit the base fields.

Some fields are gated by role and rejected with 401 if present without the
required role:

user_id, company_id, budget_cents, budget_currency require the caller
to act as a manager (admin or card_issuing_requests_manage).
tracking_number, tracking_url, estimated_delivery_date and the milestone
timestamps printing_at / sent_at / delivered_at are Cardda staff-only.
status is only accepted from an admin.

name

string

Display name for the card.

interval

string

enum

Allowed:

physical

boolean

Cannot be changed after creation (validation rejects the change).

purchase

string

enum

Allowed:

recipient_name

string

Recipient full name. Cannot be blanked on physical CLP requests.

contact_phone

string

shipping_address

object

Cannot be blanked on physical CLP requests.

user_id

string

Manager-only. Firebase user id of the cardholder.

company_id

uuid

Manager-only. UUID of the owning company.

budget_cents

integer

Manager-only. Requested budget in cents.

budget_currency

string

Manager-only. ISO-4217 budget currency.

status

string

enum

Admin-only. Request lifecycle status.

Allowed:

tracking_number

string

Cardda staff-only. Carrier tracking number.

tracking_url

string

Cardda staff-only. Carrier tracking URL (must start with http:// or https://).

estimated_delivery_date

date

Cardda staff-only. Estimated delivery date.

Headers

company-id

uuid

required

UUID of the company that owns the card.

Responses

401

Unauthorized — a role-gated field (admin/manager/staff-only) was sent without the required role.

404

Card issuing request not found (or not visible to the caller).

422

Unprocessable Entity — model validation failed (e.g. changing physical, blanking shipping data).

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The updated card issuing request.