Update program transfer type - Marqeta Docs

PUT///

Use this endpoint to update a program transfer type. Include the type_token path parameter to indicate the program transfer type to update. Add the modified detail parameters to the body of the request in JSON format. Only values of parameters in the request are modified; all others are left unchanged.

URL path parameters

Fields	Description
type_token string Required	Unique identifier of the program transfer type. Allowable Values: Existing program transfer type token

Request body

Fields	Description
memo string Required	Memo or note describing the program transfer type. Allowable Values: 1–99 chars
program_funding_source_token string Required	Unique identifier of the program funding source to which program transfers will be credited. Send a `GET` request to `/fundingsources/program` to retrieve program funding source tokens. Allowable Values: 1–36 chars
tags string Optional	Comma-delimited list of tags describing the program transfer type. Allowable Values: 1–255 chars
token string Optional	Unique identifier of the program transfer type. If you do not include a token, the system will generate one automatically. This token is necessary for use in other API calls, so we recommend that rather than let the system generate one, you use a simple string that is easy to remember. This value cannot be updated. Allowable Values: 1–36 chars

Sample request body

JSON

{
  "program_funding_source_token": "pfs_test_02",
  "memo": "Update program funding source."
}

Response body

Fields	Description
created_time datetime Conditionally returned	The date and time when the program transfer type object was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ
last_modified_time datetime Conditionally returned	Date and time when the program transfer type object was last modified, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ
memo string Conditionally returned	Memo or note describing the program transfer type. Allowable Values: 99 char max
program_funding_source_token string Returned	Unique identifier of the program funding source to which program transfers will be credited. Allowable Values: Existing program funding source token
tags string Conditionally returned	Comma-delimited list of tags describing the program transfer type. Allowable Values: 255 char max
token string Returned	Unique identifier of the program transfer type request object. Allowable Values: 36 char max

Sample response body

JSON

{
  "token": "my_program_transfer_type_02",
  "tags": "tag1, tag2, tag3",
  "memo": "Update program funding source.",
  "program_funding_source_token": "pfs_test_02",
  "created_time": "2023-03-15T19:53:23Z",
  "last_modified_time": "2023-03-15T19:58:33Z"
}