{"method":"POST","path":"https://api.revcent.com/v2/user_third_party_integrations/{user_third_party_integration_id}","summary":"Edit A User Third Party Integration","description":"Edit a previously created User Third Party Integration using the integration ID. Only include the properties you wish to modify. For example, if you only want to modify the name of the integration, then only include the name property in the request body. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/EditUserThirdPartyIntegration.md for an in-depth overview of this operation.","operationId":"EditUserThirdPartyIntegration","parameters":[{"in":"path","name":"user_third_party_integration_id","description":"The User Third Party Integration ID","required":true,"schema":{"type":"string","description":"A 20 character user third party integration ID.","minLength":20,"maxLength":20}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"type":"string","description":"The User Third Party Integration name. Must be unique from other User Third Party Integration names."},"description":{"type":"string","description":"The User Third Party Integration description."},"enabled":{"type":"boolean","description":"Whether the User Third Party Integration is enabled."},"third_party_credentials":{"type":"object","description":"The credentials required for the third party integration. Only provide if you wish to modify the existing saved credentials in RevCent. The credentials object corresponds to the 'third_party_credentials' object when retrieving a site third party integration using the GetSiteThirdPartyIntegration operation. Credential id 'third_party_credentials.id' and fields 'third_party_credentials.fields' are required in accordance with the site third party integration. The credential fields and corresponding values will be encrypted and saved by RevCent.","additionalProperties":false,"properties":{"id":{"type":"string","description":"The third party credential ID, 'third_party_credentials.id', from the site third party integration."},"fields":{"type":"array","description":"An array of required fields and their values specific to the site third party integration 'third_party_credentials.fields'. Use the GetSiteThirdPartyIntegration operation with the third party integration ID to retrieve the list of 'third_party_credentials.fields' whose id's and corresponding value's you will need to provide.","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","description":"The ID of the field based on the id, i.e. 'credentials.fields[field].id', for the site third party integration."},"value":{"type":"string","description":"The value of the field, which will be encrypted and saved by RevCent."}},"required":["id","value"]}}},"required":["id","fields"]},"third_party_options":{"type":"array","description":"An array of options specific to the site third party integration, if the site third party integration has a non-empty third_party_options array. The options will be based on the site third party integration 'third_party_options' when retrieving a site third party integration using the GetSiteThirdPartyIntegration operation. Some site third party integrations may have no options, while others may have multiple. Each option will have an id and an array of fields. The fields for each option will also correspond to the site integration. The values for each field will be specific to a users' account with the third party and can be retrieved via the GetUserThirdPartyIntegration operation after creating the user third party integration. Remote options, where 'remote_asset' = true, are specific to a user's third party integration, can be retrieved via the GetUserThirdPartyIntegration after having previously saved the credentials.","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","description":"The id for the option based on the site third party integration. I.e. 'third_party_options[option].id'."},"fields":{"type":"array","description":"An array of fields specific to each option, i.e. 'third_party_options[option].fields'. Use the GetSiteThirdPartyIntegration operation with the third party integration ID to retrieve the list of 'third_party_options[option].fields'.","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","description":"The ID of the field based on the third_party_options[option].fields[fields].id from the site third party integration."},"value":{"type":"array","description":"The value array, which contains all value(s) corresponding to the fields.id for the site third party integration 'third_party_options[option].fields[fields].value'. Most of the time only a single entry will be necessary, but some options may have multiple entries in the value array, determined by the is_multiple property from the site integration. Remote options, where 'remote_asset' = true, are specific to a user's third party integration, can be retrieved via the GetUserThirdPartyIntegration after having previously saved the credentials.","items":{"type":"string"}}},"required":["id","value"]}}},"required":["id","fields"]}}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"user_third_party_integration_id":{"type":"string","description":"A 20 character user third party integration ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}