Refresh a customer now

POST

/v1/customers/refresh

curl --request POST \
  --url https://api.strent.dev/v1/customers/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "stripe_customer_id": "cus_123" }'

• Production
• Local development

Refreshes one customer from Stripe and waits up to 10 seconds for the refresh to finish. It waits for a successful refresh whose Stripe read starts after the call arrives; queued work may be reused. Returns no billing data; read the customer’s facts after success. A timeout does not cancel the durable synchronization. Uses a separate 60 requests per minute project and bearer limit.

Authorizations

• projectApiKey

Request Body^required

Media type application/json

object

stripe_customer_id

required

string

<= 255 characters /^cus_[^\s]+$/

Example

{
  "stripe_customer_id": "cus_123"
}

Responses

200

Customer refresh finished successfully.

Media type application/json

object

Example

{}

400

The request body is invalid.

Media type application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request body is invalid.",
    "requestId": "req_123"
  }
}

401

The Authorization header or project API key is invalid or revoked.

Media type application/json

object

error

required

object

code

required

string

Allowed values: INVALID_AUTH_HEADER API_KEY_INVALID API_KEY_REVOKED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "INVALID_AUTH_HEADER",
    "message": "The Authorization header or project API key is invalid or revoked.",
    "requestId": "req_123"
  }
}

404

The customer does not exist in the project’s Stripe mode.

Media type application/json

object

error

required

object

code

required

string

Allowed values: CUSTOMER_REFRESH_STRIPE_CUSTOMER_NOT_FOUND

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "CUSTOMER_REFRESH_STRIPE_CUSTOMER_NOT_FOUND",
    "message": "The customer does not exist in the project's Stripe mode.",
    "requestId": "req_123"
  }
}

409

The Stripe connection is missing or invalid.

Media type application/json

object

error

required

object

code

required

string

Allowed values: STRIPE_CONNECTION_REQUIRED STRIPE_CONNECTION_INVALID

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "STRIPE_CONNECTION_REQUIRED",
    "message": "The Stripe connection is missing or invalid.",
    "requestId": "req_123"
  }
}

413

The request body is too large.

Media type application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request body is too large.",
    "requestId": "req_123"
  }
}

415

The request failed.

Media type application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The request failed.",
    "requestId": "req_123"
  }
}

429

The project or pre-authentication rate limit was exceeded.

Media type application/json

object

error

required

object

code

required

string

Allowed values: RATE_LIMIT_EXCEEDED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "The project or pre-authentication rate limit was exceeded.",
    "requestId": "req_123"
  }
}

Headers

Retry-After

number

Seconds before another request is advised.

500

Strent could not complete the request.

Media type application/json

object

error

required

object

code

required

string

Allowed values: INTERNAL_ERROR

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Strent could not complete the request.",
    "requestId": "req_123"
  }
}

502

Customer refresh failed.

Media type application/json

object

error

required

object

code

required

string

Allowed values: CUSTOMER_REFRESH_FAILED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "CUSTOMER_REFRESH_FAILED",
    "message": "Customer refresh failed.",
    "requestId": "req_123"
  }
}

503

Customer refresh is unavailable.

Media type application/json

object

error

required

object

code

required

string

Allowed values: CUSTOMER_REFRESH_UNAVAILABLE

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "CUSTOMER_REFRESH_UNAVAILABLE",
    "message": "Customer refresh is unavailable.",
    "requestId": "req_123"
  }
}

504

Customer refresh has not finished; durable work continues.

Media type application/json

object

error

required

object

code

required

string

Allowed values: CUSTOMER_REFRESH_NOT_FINISHED

message

required

string

requestId

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "CUSTOMER_REFRESH_NOT_FINISHED",
    "message": "Customer refresh has not finished; durable work continues.",
    "requestId": "req_123"
  }
}